Vai al contenuto
OmniChannels.ai

Assistenti e agenti IA

VS Code + OmniChannels.ai: strumenti di messaggistica nella modalità agente di Copilot

Collegamento tramite MCPCollegamento tramite API e webhookAggiornato

In breve

VS Code si collega a OmniChannels.ai aggiungendo il nostro server MCP remoto, https://mcp.broadnet.me/mcp, a .vscode/mcp.json come server http. Un input promptString con password attivo richiede il vostro token API e lo conserva in modo sicuro, così nessuna chiave viene committata. La modalità agente di GitHub Copilot può quindi inviare messaggi di prova, elencare i template WhatsApp e leggere i rapporti di consegna mentre vi aiuta a scrivere il codice di integrazione.

Cosa potete fare

  • Scrivete codice in linea con i vostri template

    Copilot elenca i vostri template WhatsApp approvati tramite MCP e scrive un mittente con esattamente le variabili richieste da ciascun template.

    Provate a chiedere

    “Elenca i miei template WhatsApp approvati, poi scrivi un metodo C# che invii order_update con il numero d'ordine e la data di consegna.”

  • Create e testate un endpoint webhook

    Copilot scrive un endpoint per stati di consegna e messaggi in entrata, poi attivate un invio di prova per vedere arrivare payload reali.

    Provate a chiedere

    “Scrivi un endpoint webhook FastAPI che memorizzi gli stati di consegna per ID messaggio e accetti campi che variano da un canale all'altro, poi invia un SMS di prova a 447700900123 così posso vederlo arrivare.”

  • Verificate una consegna prima del rilascio

    Dopo che il vostro codice ha inviato un messaggio di prova, Copilot legge il rapporto di consegna, così potete confermare lo stato registrato dal vostro gestore.

    Provate a chiedere

    “Controlla il rapporto di consegna dell'ultimo messaggio inviato a 971500000000 e confronta il suo stato con quello registrato nel nostro database.”

  • Usate la specifica, non la memoria

    Con la nostra specifica OpenAPI nel workspace, Copilot usa percorsi e campi esatti, compresi gli invii che richiedono multipart/form-data.

    Provate a chiedere

    “Usando docs/omnichannels-openapi.yaml, scrivi un helper per l'invio massivo su WhatsApp e indica quali campi vengono inviati come multipart/form-data.”

  • Preparate testi in arabo e in inglese

    Copilot prepara il testo dei messaggi in entrambe le lingue e ve lo mostra prima di chiamare qualsiasi strumento di invio.

    Provate a chiedere

    “Scrivi la bozza di un SMS di promemoria appuntamento in arabo e in inglese, ciascuno entro un solo segmento, e mostramela prima di inviare una prova a 966500000000.”

Come si collega

Collegamento tramite MCPCollegamento tramite API e webhook

VS Code legge i server MCP da .vscode/mcp.json nel vostro workspace. Il nostro server viene aggiunto come server http con un'intestazione Authorization, e il token proviene da un input di tipo promptString con password impostato su true, così VS Code lo richiede una volta e lo tiene fuori dal file che committate.

Nella modalità agente di GitHub Copilot, gli strumenti dei server MCP abilitati compaiono nell'elenco degli strumenti, dove potete attivare o disattivare ciascuno di essi, e VS Code può chiedervi di confermare le chiamate agli strumenti. Mantenete la conferma attiva per tutto ciò che invia, perché ogni invio è un messaggio reale e addebitato. I campi di configurazione cambiano tra le versioni di VS Code: consultate la sua documentazione MCP se un campo non viene riconosciuto.

  • File: .vscode/mcp.json, tipo di server http, URL https://mcp.broadnet.me/mcp
  • Intestazione: Authorization: Bearer ${input:omnichannels-token}
  • Input del token: promptString con password: true
  • Abilitate nell'elenco degli strumenti solo quelli necessari a questo workspace

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 temporanea

    Nel portale di amministrazione aprite Integrations, poi MCP Integration, e scegliete Get temporary key.

    Guida: MCP server for AI agents
  3. 3

    Create .vscode/mcp.json

    Aggiungete un server omnichannels di tipo http con il nostro URL, un'intestazione Authorization che usa ${input:omnichannels-token} e un input promptString con password impostato su true.

    Guida: MCP server for AI agents
  4. 4

    Avviate il server e inserite la chiave

    Avviate il server da VS Code, incollate la chiave quando richiesta e controllate che gli strumenti compaiano nella modalità agente di Copilot.

  5. 5

    Limitate gli strumenti

    Nell'elenco degli strumenti, disattivate quelli non necessari a questo workspace e mantenete la conferma attiva per ogni strumento di invio.

  6. 6

    Testate sul vostro numero

    Chiedete a Copilot di inviare un messaggio di prova al vostro numero verificato, poi leggete il rapporto di consegna.

Documentazione del fornitore

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

Flusso di lavoro di esempio

Come una richiesta tipica passa da VS Code al vostro cliente e ritorna.

  1. 01

    Modalità agente di Copilot

    Chiama gli strumenti MCP mentre vi aiuta a scrivere codice

  2. 02

    Server MCP OmniChannels.ai

    Invia, elenca i template e legge i rapporti con il vostro token

  3. 03

    Il vostro telefono di prova

    WhatsApp o SMS di prova al vostro numero verificato

  4. 04

    Rapporto di consegna

    Copilot rilegge lo stato con uno strumento di lettura

1. Modalità agente di Copilot: Chiama gli strumenti MCP mentre vi aiuta a scrivere codice 2. Server MCP OmniChannels.ai: Invia, elenca i template e legge i rapporti con il vostro token 3. Il vostro telefono di prova: WhatsApp o SMS di prova al vostro numero verificato 4. Rapporto di consegna: Copilot rilegge lo stato con uno strumento di lettura

Domande

Esiste un'estensione OmniChannels.ai per VS Code?

No. VS Code si collega tramite il suo supporto standard per i server MCP in .vscode/mcp.json, usando il nostro endpoint pubblico e il vostro token API. Non c'è nulla da installare dal marketplace delle estensioni.

Dove viene conservato il mio token?

Con un input promptString impostato su password: true, VS Code chiede il token all'avvio del server e lo conserva in modo sicuro invece di scriverlo in mcp.json. Committate il file, mai la chiave.

Quale modalità di Copilot usa gli strumenti?

Gli strumenti MCP si usano nella modalità agente di Copilot, dove scegliete quali strumenti sono disponibili. Consultate la documentazione aggiornata di VS Code per la vostra versione e per eventuali policy dell'organizzazione che controllano MCP.

Posso usare la stessa configurazione in altri editor?

Qualsiasi client che supporti Streamable HTTP e un'intestazione Authorization personalizzata può usare lo stesso endpoint, anche se ognuno conserva la configurazione nel proprio formato. Nella guida al server MCP trovate esempi per Cursor e Claude Code.

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.