Skip to main content

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.
L’agente risponde da solo ai tuoi clienti. Una modifica alle istruzioni vale dal messaggio successivo, anche nelle conversazioni già aperte. Fai le prove prima con un agente spento o senza numeri, con la card Prova del pannello.

Parametri

Request Body

Gli stessi campi della creazione, tutti facoltativi. Almeno uno è necessario.

Cambiare l’orario

  • schedule.mode è sempre obbligatorio dentro schedule.
  • 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 slots le 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.
Le regole di ogni fascia sono in Crea un agente.

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 questo id 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 portano min 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.