Documentazione

Panoramica dei canali

Catalogo dei canali di ingresso disponibili e criteri per scegliere quello giusto.

Un canale è la sorgente di un evento da elaborare tramite una pipeline. Ogni canale è un modulo indipendente: aggiungere un canale email non ha alcun impatto sul canale telefonico.

Un canale innesca una pipeline. Per leggere dati o agire su uno strumento esterno all'interno di una pipeline (Stripe, GitHub, Google, LinkedIn, telefonia), consulta Integrazioni.

Voce in tempo reale

  • Telefonia — LiveKit + SIP, trascrizione e sintesi in streaming, barge-in, trasferimento. Chiamate in entrata, e chiamate in uscita avviate da una pipeline.

Scrittura asincrona

  • Email — IMAP, parsing degli allegati, thread preservati.
  • WhatsApp — Cloud API, media. Oppure Green API per un numero senza account Meta Business (Beta, non ufficiale).
  • Messenger — messaggi ricevuti sulla tua Pagina Facebook.
  • Telegram — Bot API, gruppi e conversazioni private.
  • Mattermost — Webhook in uscita, thread.
  • Slack — Events API, firma verificata.
  • SMS — risposte in entrata tramite AllMySMS, oppure tramite Brevo.

Web

  • Widget chat — script JS integrabile in qualsiasi sito web.
  • Webhook HTTP — ricezione generica di POST firmati.
  • Agente esterno (MCP) — un'IA di terze parti conversa con uno dei tuoi modelli, se il suo Start dichiara il ricevitore external_agent_inbound.

Sistemi esterni

  • Meta Lead Ads — ricezione istantanea dei lead Facebook / Instagram.
  • Schedule (cron) — trigger ricorrenti.
  • Onoff Business — una chiamata terminata o un SMS su una linea Onoff (Beta, sola lettura).
  • Esito di una chiamata in uscita — il ricevitore phone_call_outcome innesca una pipeline al termine di una chiamata effettuata tramite phone_call.
  • E i trigger delle integrazioni: nuovo file su Google Drive, evento di calendario imminente, ispezione Mitti, fine del rendering HeyGen.

Scegliere il canale giusto

Vuoi…Canale consigliato
Automatizzare una chiamata telefonica in entrata o in uscitaTelefonia
Smistare automaticamente le email di supportoEmail
Avviare una chat sul tuo sito marketingWidget chat
Ricevere i lead Meta direttamenteMeta Lead Ads
Collegare uno strumento interno che parla HTTPWebhook
Avviare una pipeline giornaliera alle 8Schedule
Rispondere ai messaggi WhatsApp su un numero aziendaleWhatsApp
Rispondere ai messaggi della tua Pagina FacebookMessenger
Richiamare un lead appena arrivaSchedule o webhook + nodo phone_call

Anatomia comune

Tutti i canali seguono lo stesso contratto interno:

  1. Ricevere un evento (HTTP, WebSocket, scheduler, SIP…).
  2. Autenticare l'evento (firma, token, identificatore org).
  3. Normalizzare il payload nel formato interno (ExchangeInput).
  4. Innescare la pipeline di destinazione configurata nella tua organizzazione.

Conseguenza pratica: la pipeline che progetti non dipende dal canale di ingresso. Puoi passare dall'email a WhatsApp senza cambiare nulla a valle.

Limitazioni

Alcuni canali hanno prerequisiti esterni (numero SIP, app Meta, dominio WhatsApp verificato). Consulta la pagina dedicata di ciascun canale per l'elenco completo.