> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mycentralino.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Disattiva un agente su un numero

> Toglie un numero WhatsApp a un Agente AI: su quel numero rispondono solo le persone del team

# DELETE /v1/whatsapp/agents/\{id}/numbers/\{phone}

Disattiva un Agente AI su **un** numero WhatsApp: toglie quel numero all'agente. Da quel momento l'agente non risponde più ai clienti che scrivono a quel numero, e le risposte tornano alle persone del team. Le conversazioni restano dove sono, in Inbox.

L'agente **resta acceso** e continua a rispondere sugli altri suoi numeri. Se era il suo ultimo numero, rimane acceso ma senza numeri (`active_now: false`) e ricomincia a rispondere appena gli [attivi](https://docs.mycentralino.com/mycentralino-api/whatsapp-agents-attach.md) un numero.

> [!NOTE]
>
> Non c'è una rotta per spegnere un agente. Per fermarlo del tutto togligli tutti i numeri con questa rotta, oppure spegnilo dal pannello, in **MyFlow → Agenti AI**.

> [!WARNING]
>
> Per riattivare l'agente su questo numero serve il metodo di pagamento su Meta, come per qualunque numero nuovo. Se intanto l'account WhatsApp Business l'ha perso, il numero non si potrà riassegnare finché non viene aggiunto di nuovo. Prima di disattivare un agente che vuoi riattivare più tardi, controlla che il numero sia a posto.

## Parametri

| Campo | Tipo | Obbligatorio | Descrizione |
| - | - | - | - |
| `id` | int (path) | ✅ | L'`id` dell'agente, da [GET /v1/whatsapp/agents](https://docs.mycentralino.com/mycentralino-api/whatsapp-agents-list.md) |
| `phone` | string (path) | ✅ | Il numero WhatsApp da togliere, con sole cifre (da 8 a 15), con o senza `+`. Il `+` nell'indirizzo va scritto `%2B`, oppure lo puoi omettere |

Non serve un body.

## Richiesta

```bash cURL theme={null}
curl -X DELETE "https://api.mycentralino.com/v1/whatsapp/agents/7/numbers/%2B390212345679" \
  -H "X-API-KEY: sk_mycentralino_your_api_key"
```

```php PHP theme={null}
<?php
$url = 'https://api.mycentralino.com/v1/whatsapp/agents/7/numbers/' . rawurlencode('+390212345679');

$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'DELETE',
    CURLOPT_HTTPHEADER => [
        'X-API-KEY: sk_mycentralino_your_api_key'
    ]
]);
$response = curl_exec($ch);
curl_close($ch);
print_r(json_decode($response, true));
```

```python Python theme={null}
import requests
from urllib.parse import quote

headers = {'X-API-KEY': 'sk_mycentralino_your_api_key'}
phone = quote('+390212345679', safe='')
response = requests.delete(f'https://api.mycentralino.com/v1/whatsapp/agents/7/numbers/{phone}', headers=headers)
print(response.json())
```

## Risposta

`200 OK`, con l'agente com'è dopo la modifica.

```json theme={null}
{
  "success": true,
  "data": {
    "id": 7,
    "name": "Assistente Studio",
    "enabled": true,
    "active_now": true,
    "schedule": {
      "mode": "always"
    },
    "numbers": [
      { "phone": "+390212345678", "name": "Studio Rossi" }
    ],
    "knowledge_docs": 3,
    "replies_7d": 42
  }
}
```

I campi sono descritti in [Elenco Agenti AI](https://docs.mycentralino.com/mycentralino-api/whatsapp-agents-list.md#campi-di-ogni-agente). Dopo la disattivazione il numero compare tra i `free_numbers` di [GET /v1/whatsapp/agents](https://docs.mycentralino.com/mycentralino-api/whatsapp-agents-list.md).

Ogni disattivazione lascia una riga nel **Log attività** del pannello.

## Errori

### 400 - invalid\_number

Il numero nel percorso non è riconoscibile.

### 404 - agent\_not\_found

Non esiste un agente con questo `id` su questo account.

### 404 - number\_not\_found

Il numero non è tra quelli WhatsApp collegati a MyFlow su questo account.

### 404 - not\_assigned

L'agente non è attivo su questo numero: non c'è niente da togliere. Se ripeti una disattivazione già riuscita ricevi questo errore, e puoi considerarlo un esito positivo.

### 409 - agent\_update\_failed

Il numero è cambiato mentre la richiesta era in corso, per esempio per una modifica fatta nello stesso momento dal pannello. Rileggi con [GET /v1/whatsapp/agents](https://docs.mycentralino.com/mycentralino-api/whatsapp-agents-list.md) e riprova.

### 403 - agents\_not\_enabled

Gli Agenti AI non sono disponibili su questo account.

Gli errori comuni a tutte le rotte sono nell'[introduzione](https://docs.mycentralino.com/mycentralino-api/whatsapp-introduction.md#codici-di-errore).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.