POST /v1/whatsapp/agents/{id}/numbers
Attiva un Agente AI su un numero WhatsApp:- aggiunge il numero a quelli dell’agente, e i numeri che aveva già restano;
- se l’agente era spento, lo accende.
Un numero ha al massimo un agente. Se il numero è già servito da un altro agente dell’account, la richiesta viene rifiutata con
number_taken, a meno che tu non chieda di spostarlo con "move": true.Parametri
Request Body
Che cosa succede
La richiesta si può ripetere senza effetti doppi: se l’agente è già attivo su quel numero risponde
changed: false.
Il metodo di pagamento su Meta si controlla solo quando il numero si aggiunge all’agente, anche quando lo sposti da un altro agente con move. Se il numero era già suo, non serve.
Ogni attivazione che cambia qualcosa lascia una riga nel Log attività del pannello.
Richiesta
Risposta
200 OK, con l’agente com’è dopo la modifica.
Campi della risposta
I campi dell’agente sono descritti in Elenco Agenti AI. In più:active_now può essere false anche subito dopo un’attivazione riuscita: succede quando l’agente ha delle fasce orarie e in questo momento è fuori orario. Comincerà a rispondere alla prossima fascia.
Errori
400 - invalid_number
number manca, non è una stringa o non è un numero di telefono riconoscibile. Esempio valido: +390612345678.
404 - agent_not_found
Non esiste un agente con questoid su questo account.
404 - number_not_found
Il numero non è tra quelli WhatsApp collegati a MyFlow su questo account. L’elenco è in GET /v1/whatsapp/numbers.409 - number_taken
Il numero è già servito da un altro agente dell’account. Il messaggio ne dice il nome eerror.agent lo identifica. Per spostarlo su questo agente, ripeti la richiesta con "move": true.
