Vai al contenuto
OmniChannels.ai

Assistenti e agenti IA

Google Gemini + OmniChannels.ai: strumenti di messaggistica per gli agenti Gemini

Collegamento tramite MCPCollegamento tramite API e webhookAggiornato

In breve

Gli agenti Gemini si collegano a OmniChannels.ai tramite il nostro server MCP remoto all'indirizzo https://mcp.broadnet.me/mcp. Nell'Agent Development Kit, un MCPToolset usa Streamable HTTP con il vostro token in un'intestazione Authorization; Gemini CLI accetta lo stesso URL e la stessa intestazione nelle sue impostazioni. L'agente può quindi inviare messaggi WhatsApp, SMS e RCS, usare template approvati e leggere i rapporti di consegna. Non è coinvolta alcuna app su marketplace Google.

Cosa potete fare

  • Aggiornamenti ai clienti da un agente ADK

    Un agente creato con l'Agent Development Kit invia aggiornamenti su spedizioni o appuntamenti quando la vostra applicazione lo richiede.

    Provate a chiedere

    “Invia un messaggio WhatsApp a 971500000000 per dire che il suo ordine è stato spedito e arriverà domani.”

  • Template per i clienti in Arabia Saudita e negli EAU

    L'agente elenca i template WhatsApp approvati e compila la versione in arabo o in inglese più adatta.

    Provate a chiedere

    “Elenca i miei template WhatsApp in arabo approvati e invia order_update a 966500000000 con numero ordine INV-400.”

  • Invii di prova da Gemini CLI

    Gli sviluppatori inviano un messaggio di prova o controllano un rapporto di consegna dal terminale mentre sviluppano.

    Provate a chiedere

    “Invia un SMS di prova al mio numero verificato e dimmi lo stato di consegna.”

  • Analisi delle consegne

    Un agente di sola lettura, con il solo strumento dei rapporti di consegna, riassume i fallimenti per il vostro team.

    Provate a chiedere

    “Quanti messaggi della campagna estratti conto di ieri sono falliti e quali sono stati i motivi più frequenti?”

  • Combinate con i dati della vostra azienda

    Se l'agente dispone anche di uno strumento per BigQuery, il vostro CRM o il vostro negozio, può recuperare lì i destinatari e inviare tramite OmniChannels.ai.

    Provate a chiedere

    “Invia un aggiornamento d'ordine via WhatsApp ai clienti i cui ordini sono stati spediti oggi.”

Come si collega

Collegamento tramite MCPCollegamento tramite API e webhook

OmniChannels.ai gestisce un server MCP remoto su Streamable HTTP. Ogni richiesta porta il vostro token API in un'intestazione Authorization: Bearer e ogni strumento agisce con i permessi, i Sender ID e il saldo di quel token, esattamente come farebbe il vostro codice.

Nell'Agent Development Kit, aggiungete un MCPToolset i cui parametri di connessione Streamable HTTP contengano il nostro URL e l'intestazione Authorization, e filtratelo sugli strumenti necessari all'agente. Un agente ADK può essere distribuito su Vertex AI Agent Engine; conservate il token in Secret Manager invece che nel codice. Gemini CLI legge i server MCP dal suo file di impostazioni, usando httpUrl per l'endpoint e headers per il token.

  • Endpoint: https://mcp.broadnet.me/mcp (Streamable HTTP)
  • Autenticazione: Authorization: Bearer <token>; usate una chiave temporanea durante i test
  • ADK: MCPToolset con parametri di connessione Streamable HTTP e headers
  • Gemini CLI: voce mcpServers con httpUrl e headers
  • Senza MCP, l'agente può chiamare la nostra API REST usando la specifica OpenAPI

Configurazione

  1. 1

    Richiedete l'accesso API

    Richiedete l'accesso di prova e ricevete un token API. Gli invii di prova arrivano solo ai vostri numeri verificati.

  2. 2

    Ottenete una chiave MCP

    Nel portale di amministrazione aprite Integrations, poi MCP Integration, e copiate una chiave temporanea.

    Guida: MCP server for AI agents
  3. 3

    Aggiungete il toolset al vostro agente

    In ADK, create un MCPToolset con parametri Streamable HTTP per https://mcp.broadnet.me/mcp e l'intestazione Authorization, leggendo il token da una variabile d'ambiente o da un secret.

  4. 4

    Oppure aggiungetelo a Gemini CLI

    Aggiungete una voce mcpServers con httpUrl impostato sul nostro endpoint e un'intestazione Authorization in headers, poi riavviate la CLI.

  5. 5

    Limitate gli strumenti e confermate gli invii

    Esponete solo gli strumenti necessari all'agente e richiedete un passaggio di conferma prima di ogni invio, perché ogni invio è un messaggio reale e addebitato.

  6. 6

    Testate, poi distribuite

    Inviate un messaggio di prova al vostro numero verificato e controllate il rapporto di consegna prima di distribuire l'agente su Vertex AI Agent Engine.

Documentazione del fornitore

Google Gemini and Vertex AI è un marchio del rispettivo proprietario. OmniChannels.ai non è affiliata a Google Gemini and Vertex AI né da essa approvata; questa pagina descrive un collegamento realizzato con le funzioni MCP, HTTP o webhook di Google Gemini and Vertex AI.

Flusso di lavoro di esempio

Come una richiesta tipica passa da Google Gemini and Vertex AI al vostro cliente e ritorna.

  1. 01

    Agente Gemini

    Creato con ADK, oppure Gemini CLI sul vostro computer

  2. 02

    Server MCP OmniChannels.ai

    La chiamata del toolset porta il vostro token Bearer

  3. 03

    Telefono del cliente

    Messaggio WhatsApp, SMS o RCS consegnato

  4. 04

    Rapporto di consegna

    L'agente rilegge lo stato con uno strumento di lettura

1. Agente Gemini: Creato con ADK, oppure Gemini CLI sul vostro computer 2. Server MCP OmniChannels.ai: La chiamata del toolset porta il vostro token Bearer 3. Telefono del cliente: Messaggio WhatsApp, SMS o RCS consegnato 4. Rapporto di consegna: L'agente rilegge lo stato con uno strumento di lettura

Domande

Esiste un'app ufficiale OmniChannels.ai per Gemini?

No. Gli agenti Gemini si collegano tramite il supporto MCP di Google nell'Agent Development Kit e in Gemini CLI, usando il nostro endpoint MCP pubblico e il vostro token API.

Posso usarlo nell'app Gemini?

Questa pagina riguarda i percorsi per sviluppatori: agenti creati con l'Agent Development Kit, Vertex AI Agent Engine e Gemini CLI. Per il supporto MCP in altri prodotti Gemini consultate la documentazione aggiornata di Google.

Dove deve stare il token in produzione?

Tenetelo fuori dal codice e dalla configurazione che committate. Su Google Cloud, conservatelo in Secret Manager e passatelo all'agente a runtime.

Google ottiene accesso ai dati dei miei clienti?

Il modello vede ciò che gli strumenti restituiscono, come template e rapporti di consegna, oltre a tutto ciò che la vostra applicazione inserisce nella conversazione. Il token limita l'agente ai permessi del vostro account.

Richiedi l’accesso a API e MCP

Indicateci canali, Paesi e caso d’uso. Un tecnico emette le credenziali di test e verifica i vostri numeri di prova.