Documentazione

Messaggistica (WhatsApp, Messenger, Telegram, Mattermost)

Collega una pipeline a WhatsApp (Cloud API, o Green API in Beta), Messenger, Telegram Bot API o Mattermost.

betool integra le piattaforme di messaggistica più richieste. Ognuna segue lo stesso modello: un modulo *_inbound per la ricezione e un modulo *_outbound per l'invio.

WhatsApp Business

Prerequisiti

  • Account Meta Business.
  • Numero WhatsApp Business approvato.
  • Applicazione Cloud API configurata con un webhook.

Configurazione

  1. Impostazioni → Servizi → WhatsApp, scheda Account — collega la tua app Meta con il suo App Secret e Phone Number ID.
  2. Lato Meta, aggiungi l'URL del webhook fornito da betool (https://platform.betool.ai/entries/whatsapp/<id>) e copia il Verify Token generato.
  3. Associa il numero a una pipeline.

Specificità

  • I template approvati sono obbligatori per avviare una conversazione (al di fuori della finestra di 24 ore). Gestisci i template lato Meta; betool li referenzia tramite nome.
  • Media supportati: immagini, audio, video, documenti. I documenti PDF ed Excel possono poi essere elaborati dal nodo file_transform.

WhatsApp tramite Green API (Beta)

Beta. Il connettore Green API non è ancora stato messo alla prova su un account cliente reale in produzione.

Per un numero WhatsApp senza account Meta Business, betool si collega anche a Green API (la tua istanza, BYO): il ricevitore greenapi_inbound innesca una pipeline a ogni messaggio ricevuto (media copiati in betool), il nodo greenapi_outbound invia un testo o un file con didascalia. betool installa da sé il webhook presso Green API.

  • Non è l'API ufficiale di WhatsApp: Green API emula WhatsApp Web. WhatsApp può bannare il numero, senza possibilità di ricorso. Per un uso con i clienti a volume, preferisci la Cloud API sopra descritta.
  • Nessun template né finestra di 24 ore; i gruppi sono accessibili.
  • Un invio riuscito dimostra che il messaggio è in coda, non che è stato consegnato.
  • L'invio passa unicamente dal nodo (exactly-once): nessun tool consente a un agente di inviare da solo.

Messenger

Il ricevitore messenger_inbound innesca una pipeline a ogni messaggio ricevuto sulla tua Pagina Facebook; il nodo messenger_outbound risponde. Le risposte libere sono possibili solo nelle 24 ore successive all'ultimo messaggio dell'utente (regola Meta). Dettagli e connessione: Meta.

Telegram

Prerequisiti

Un bot creato tramite @BotFather (token API).

Configurazione

  1. Impostazioni → Servizi → Telegram, scheda Account — incolla il token; betool configura automaticamente il webhook.
  2. Associa il bot a una pipeline.

Specificità

  • Il bot può essere aggiunto a gruppi o usato in conversazioni private.
  • Nessuna quota restrittiva come WhatsApp — ideale per assistenti interni o notifiche operative.

Mattermost

Prerequisiti

  • Un'istanza Mattermost (cloud o self-hosted).
  • Un webhook in uscita lato Mattermost.

Configurazione

  1. Impostazioni → Servizi → Mattermost, scheda Account — crea la connessione e copia l'URL fornito da betool.
  2. Lato Mattermost, crea un webhook in uscita che punti a quell'URL.
  3. Facoltativo: crea un incoming webhook su Mattermost per consentire a betool di pubblicare risposte.

Specificità

  • Thread preservati — le risposte dell'agent restano nel thread della domanda originale.
  • Canali privati / DM — scegli l'ambito durante la configurazione.

Scegliere

Caso d'usoRaccomandazione
Supporto clienti consumer esternoWhatsApp
Assistente per team internoTelegram o Mattermost (a seconda di ciò che è già distribuito)
Bot operativo IT / DevOpsMattermost
Presenza multicanalePuoi collegare la stessa pipeline a più canali simultaneamente