Messaggistica
WhatsApp Business
Invio di messaggi WhatsApp (testo nelle 24 ore di sessione, modelli approvati sempre), con conferma.
- Token o credenziali
- Azioni con conferma
Strumenti per l’agente
L’agente sceglie da solo lo strumento adatto alla domanda. Nella scheda MCP e database dell’agente puoi disattivare quelli che non servono.
| Strumento | Cosa fa | Tipo |
|---|---|---|
list_templates | Modelli di messaggio approvati (nome, lingua, testo). | Lettura |
send_message | Invia un messaggio di testo (solo entro 24 ore dall’ultimo messaggio del contatto). Richiede conferma. | Con conferma |
send_template | Invia un modello approvato con i parametri del testo. Richiede conferma. | Con conferma |
Configurazione passo per passo
In Kaiross apri Integrazioni, scegli WhatsApp Business e premi Nuova connessione. Il modulo mostra la stessa guida sotto Guida e permessi consigliati.
- developers.facebook.com → App di tipo Business con il prodotto WhatsApp; collega il numero aziendale.
- Business Manager → Utenti di sistema → genera un token permanente con
whatsapp_business_messagingewhatsapp_business_management. - Fuori dalla finestra di 24 ore si possono inviare solo modelli approvati da Meta.
- Per reagire ai messaggi in arrivo usa un’automazione con trigger webhook collegato all’app Meta.
Campi del modulo: Phone number ID, WhatsApp Business Account ID (per i modelli).
Da incollare (cifrato nel Vault, poi non più visibile): Access token (utente di sistema).
Collegarla a un agente
- Apri Agenti, scegli l’agente e vai alla scheda MCP e database.
- In Aggiungi scegli Collega un’integrazione esistente e seleziona la connessione, oppure Dal catalogo per crearne una nuova (il pulsante diventa Salva e collega).
- Controlla gli Strumenti abilitati e, in Conferma delle azioni, quali azioni devono chiedere conferma.
- Premi Prova in chat e fai una domanda che richiede i dati del servizio.
Errori frequenti
- Credenziali non valide
- Controlla token, password o chiave API: spesso manca un carattere o il token è scaduto. Creane uno nuovo e aggiorna la connessione.
- Permessi insufficienti
- All’account o al token mancano i permessi necessari: confrontali con la configurazione qui sopra (Guida e permessi consigliati nell’app) e, se serve, crea un token nuovo.
- Troppe richieste
- Il servizio limita la frequenza delle chiamate: riprova tra qualche minuto.
Link utili
Console del fornitore citate nei passi: