Ir para o conteúdo
OmniChannels.ai

Assistentes e agentes de IA

VS Code + OmniChannels.ai: ferramentas de mensagens no modo agente do Copilot

Conexão via MCPConexão via API e webhooksAtualizado em

Em resumo

O VS Code se conecta à OmniChannels.ai adicionando o nosso servidor MCP remoto, https://mcp.broadnet.me/mcp, ao .vscode/mcp.json como servidor http. Um input promptString com password ativado pede o seu token de API e o armazena com segurança, então nenhuma chave é versionada. O modo agente do GitHub Copilot pode então enviar mensagens de teste, listar modelos do WhatsApp e ler relatórios de entrega enquanto ajuda você a escrever o código da integração.

O que você pode fazer

  • Escrever código alinhado aos seus modelos

    O Copilot lista seus modelos aprovados do WhatsApp via MCP e escreve uma rotina de envio com exatamente as variáveis de que cada modelo precisa.

    Experimente pedir

    “Liste meus modelos de WhatsApp aprovados e depois escreva um método em C# que envie o order_update com o número do pedido e a data de entrega.”

  • Criar e testar um endpoint de webhook

    O Copilot escreve um endpoint para status de entrega e mensagens recebidas, e você dispara um envio de teste para ver payloads reais chegando.

    Experimente pedir

    “Escreva um endpoint de webhook em FastAPI que armazene status de entrega por ID de mensagem e aceite campos que variam por canal, e depois envie um SMS de teste para 447700900123 para eu acompanhar a chegada.”

  • Conferir uma entrega antes de publicar

    Depois que o seu código envia uma mensagem de teste, o Copilot lê o relatório de entrega para você confirmar o status que o seu handler registrou.

    Experimente pedir

    “Confira o relatório de entrega da última mensagem enviada para 971500000000 e compare o status com o que o nosso banco de dados registrou.”

  • Usar a especificação, não a memória

    Com a nossa especificação OpenAPI no workspace, o Copilot usa os caminhos e campos exatos, incluindo quais envios exigem multipart/form-data.

    Experimente pedir

    “Usando docs/omnichannels-openapi.yaml, escreva um helper de envio de WhatsApp em massa e indique quais campos são enviados como multipart/form-data.”

  • Redigir textos em árabe e inglês

    O Copilot redige o texto da mensagem nos dois idiomas e mostra a você antes de chamar qualquer ferramenta de envio.

    Experimente pedir

    “Escreva um SMS de lembrete de consulta em árabe e inglês, com no máximo um segmento cada, e me mostre antes de enviar um teste para 966500000000.”

Como a conexão funciona

Conexão via MCPConexão via API e webhooks

O VS Code lê servidores MCP do .vscode/mcp.json no seu workspace. O nosso servidor é adicionado como servidor http com um cabeçalho Authorization, e o token vem de um input do tipo promptString com password definido como true, então o VS Code o solicita uma vez e o mantém fora do arquivo que você versiona.

No modo agente do GitHub Copilot, as ferramentas dos servidores MCP ativos aparecem na lista de ferramentas, onde você pode ativar ou desativar cada uma, e o VS Code pode pedir que você confirme as chamadas de ferramenta. Mantenha a confirmação ativa em tudo que envia, já que cada envio é uma mensagem real e cobrada. Os campos de configuração mudam entre versões do VS Code, então consulte a documentação de MCP se algum campo não for reconhecido.

  • Arquivo: .vscode/mcp.json, tipo de servidor http, URL https://mcp.broadnet.me/mcp
  • Cabeçalho: Authorization: Bearer ${input:omnichannels-token}
  • Input do token: promptString com password: true
  • Ative na lista de ferramentas apenas as que este workspace precisa

Configuração

  1. 1

    Solicite acesso à API

    Solicite acesso de teste e receba um token de API. Os envios de teste só vão para os seus próprios números verificados.

  2. 2

    Obtenha uma chave temporária

    No portal de administração, abra Integrations e depois MCP Integration, e escolha Get temporary key.

    Guia: MCP server for AI agents
  3. 3

    Crie o .vscode/mcp.json

    Adicione um servidor omnichannels do tipo http com a nossa URL, um cabeçalho Authorization que usa ${input:omnichannels-token} e um input promptString com password definido como true.

    Guia: MCP server for AI agents
  4. 4

    Inicie o servidor e informe a chave

    Inicie o servidor pelo VS Code, cole a sua chave quando solicitado e verifique se as ferramentas aparecem no modo agente do Copilot.

  5. 5

    Limite as ferramentas

    Na lista de ferramentas, desative as que este workspace não precisa e mantenha a confirmação ativa em toda ferramenta de envio.

  6. 6

    Teste no seu próprio número

    Peça ao Copilot para enviar uma mensagem de teste ao seu número verificado e depois leia o relatório de entrega.

Documentação do fornecedor

VS Code é uma marca de seu proprietário. A OmniChannels.ai não é afiliada nem endossada por VS Code; esta página descreve uma conexão feita com os recursos de MCP, HTTP ou webhook do próprio VS Code.

Fluxo de exemplo

Como uma solicitação típica vai de VS Code até o seu cliente e volta.

  1. 01

    Modo agente do Copilot

    Chama ferramentas MCP enquanto ajuda você a programar

  2. 02

    Servidor MCP OmniChannels.ai

    Envia, lista modelos e lê relatórios com seu token

  3. 03

    Seu celular de teste

    WhatsApp ou SMS de teste para o seu número verificado

  4. 04

    Relatório de entrega

    O Copilot lê o status com uma ferramenta de leitura

1. Modo agente do Copilot: Chama ferramentas MCP enquanto ajuda você a programar 2. Servidor MCP OmniChannels.ai: Envia, lista modelos e lê relatórios com seu token 3. Seu celular de teste: WhatsApp ou SMS de teste para o seu número verificado 4. Relatório de entrega: O Copilot lê o status com uma ferramenta de leitura

Perguntas

Existe uma extensão da OmniChannels.ai para o VS Code?

Não. O VS Code se conecta pelo suporte padrão a servidores MCP no .vscode/mcp.json, usando o nosso endpoint público e o seu token de API. Não é preciso instalar nada do marketplace de extensões.

Onde o meu token fica armazenado?

Com um input promptString definido como password: true, o VS Code pede o token quando o servidor inicia e o armazena com segurança, em vez de gravá-lo no mcp.json. Versione o arquivo, nunca a chave.

Qual modo do Copilot usa as ferramentas?

As ferramentas MCP são usadas no modo agente do Copilot, em que você escolhe quais ferramentas ficam disponíveis. Consulte a documentação atual do VS Code para a sua versão e as políticas da sua organização que controlam o MCP.

Posso usar a mesma configuração em outros editores?

Qualquer cliente que suporte Streamable HTTP e um cabeçalho Authorization personalizado pode usar o mesmo endpoint, embora cada um armazene a configuração no próprio formato. Veja o guia do servidor MCP para exemplos com Cursor e Claude Code.

Obtenha acesso à API e ao MCP

Conte quais canais, países e caso de uso você tem. Um engenheiro emite suas credenciais de teste e verifica seus números de teste.