PATCH /v1/whatsapp/agents/{id}
Modifica un Agente AI. Manda solo i campi da cambiare: quelli assenti restano come sono. La risposta è l’agente aggiornato, con l’elenco dei campi cambiati davvero. Con"enabled": false spegni l’agente su tutti i suoi numeri in una volta. Con "enabled": true lo riaccendi. Per sceglierne i numeri ci sono le rotte di attivazione e disattivazione.
Parametri
Request Body
Gli stessi campi della creazione, tutti facoltativi. Almeno uno è necessario.Cambiare l’orario
schedule.modeè sempre obbligatorio dentroschedule.schedule.slots, se c’è, sostituisce tutta la settimana: un giorno che non mandi resta senza fasce. Per cambiare un giorno solo, leggi prima le fasce con il dettaglio e rimandale tutte.- Senza
slotsle fasce salvate restano come sono. Così{"schedule": {"mode": "always"}}mette l’agente sempre attivo senza perdere le fasce, e{"schedule": {"mode": "slots"}}lo rimette sulle fasce che aveva, se ne ha almeno una.
Richiesta
Risposta
200 OK con l’agente aggiornato, nella forma del dettaglio, più changed.
Ogni modifica lascia una riga nel Log attività del pannello, con i nomi dei campi cambiati. Il testo delle istruzioni non viene scritto.
Errori
404 - agent_not_found
Non c’è un agente con questoid su questo account.
422 - empty_update
Il body non ha campi da modificare.422 - invalid_schedule
schedule non ha la forma giusta, oppure mode: "slots" senza fasce né mandate né già salvate. Il messaggio dice cosa correggere.
422 - invalid_name / invalid_instructions / invalid_handoff_message / invalid_max_replies / invalid_reply_delay_seconds / invalid_human_pause_minutes / invalid_enabled
Un campo non valido: le regole sono in Crea un agente. Gli errori sui numeri portanomin e max.
422 - unknown_fields
Un campo che non esiste,provider e model compresi. L’errore elenca i campi sbagliati in fields e quelli ammessi in allowed.
Se il body ha un errore, non si salva niente: nemmeno i campi giusti.
Gli errori comuni a tutte le rotte sono nell’introduzione.