Skip to main content

GET /v1/whatsapp/agents

Restituisce gli Agenti AI di MyFlow, quelli che rispondono ai clienti su WhatsApp quando nessuno del team lo sta facendo. Per ognuno dice se è acceso, se in questo momento sta rispondendo, su quali numeri e in quali orari. In più elenca i numeri WhatsApp che non hanno un agente. Usala per mostrare nel gestionale chi risponde su ogni numero, e prima di attivare o disattivare un agente su un numero.
L’elenco è un riassunto. Istruzioni, frase di passaggio e regole di risposta sono nel dettaglio, e la conoscenza in Conoscenza dell’agente. Dall’API un agente si crea e si modifica. Si elimina e riceve file di conoscenza solo dal pannello, in MyFlow → Agenti AI. Il modello non si vede e non si sceglie.

Come funziona un agente

  • Un numero ha al massimo un agente. Un agente invece può rispondere su più numeri.
  • Un agente risponde davvero su un numero solo se è acceso (enabled), ha quel numero tra i suoi (numbers) ed è in orario: sempre, oppure dentro una delle sue fasce (schedule). È quello che riassume active_now.
  • Anche con active_now: true l’agente si fa da parte, conversazione per conversazione, quando c’è una persona: se qualcuno del team ha scritto al cliente da poco (dal pannello, dall’app WhatsApp Business o dal gestionale con POST /v1/whatsapp/messages), se la conversazione è stata presa in carico da un collega, o se ha già dato il numero massimo di risposte in quella conversazione. Queste regole si impostano nel pannello o con PATCH /v1/whatsapp/agents/{id}.
  • Per aggiungere un numero a un agente serve un metodo di pagamento sull’account WhatsApp Business, su Meta: è la stessa regola del pannello. free_numbers[].payment_method_ok lo dice in anticipo.

Parametri

Nessuno.

Richiesta

Risposta

200 OK
Se sull’account non ci sono agenti, agents è un elenco vuoto.

Campi di ogni agente

Gli agenti sono in ordine alfabetico di nome.

L’orario (schedule)

Gli orari sono sempre in ora italiana (Europe/Rome).

Numeri senza agente (free_numbers)

I numeri WhatsApp collegati a MyFlow su cui non risponde nessun agente. Un numero condiviso con un altro account MyCentralino su cui un agente c’è già non compare qui, e non si può usare. I numeri sono in ordine: prima quelli con il metodo di pagamento a posto.

Errori

403 - agents_not_enabled

Gli Agenti AI non sono disponibili su questo account. Gli errori comuni a tutte le rotte sono nell’introduzione.