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 riassumeactive_now. - Anche con
active_now: truel’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 conPATCH /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_oklo dice in anticipo.
Parametri
Nessuno.Richiesta
Risposta
200 OK
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.
