Skip to main content

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 un numero.
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.
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

Non serve un body.

Richiesta

Risposta

200 OK, con l’agente com’è dopo la modifica.
I campi sono descritti in Elenco Agenti AI. Dopo la disattivazione il numero compare tra i free_numbers di GET /v1/whatsapp/agents. 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 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.