Passar para o conteúdo principal

Como conectar o Wati MCP ao Meta Muse ou ao Gemini CLI

Resumo

Conecte o servidor Wati Model Context Protocol (MCP) ao Meta Muse ou à interface de linha de comando (CLI) do Google Gemini para trabalhar com seu workspace Wati usando linguagem natural. Uma vez conectado, você pode usar clientes de IA compatíveis para gerenciar contatos, conversas, mensagens, modelos, campanhas e outros recursos suportados.

Este guia orienta você na conexão do Wati MCP ao Meta Muse e ao Gemini CLI usando autenticação OAuth. Você pode entrar com sua conta Wati existente sem precisar criar uma nova conta ou adicionar uma chave de API à sua configuração.

Nota: O servidor Wati MCP está disponível para clientes nos planos Growth, Pro e Business do Wati. Se você estiver usando uma conta de teste (trial), também poderá ativar e usar o servidor Wati MCP durante o período de avaliação.

Instruções

Escolha o cliente de IA que você deseja conectar ao Wati e siga as etapas na seção correspondente.

Use a URL do servidor MCP que corresponde à região do seu workspace Wati:

Região do workspace

URL do servidor MCP

Global

https://mcp.wati.io/mcp

UE

https://eu-mcp.wati.io/mcp

Parte 1: Conectar o Wati MCP ao Meta Muse

Disponibilidade: O Meta Muse está disponível atualmente apenas nos Estados Unidos e Canadá. Se você estiver fora dessas regiões, conecte o Wati através do Gemini CLI (veja a Parte 2).

Conecte o Wati ao Meta Muse diretamente pelo aplicativo Muse. Você entrará na sua conta Wati existente e autorizará o acesso através do fluxo de autenticação OAuth do Wati.

Etapas para conectar

1. Abrir Conectores (Connectors)

  • Abra o aplicativo Muse, vá para Configurações (Settings) e selecione Conectores (Connectors).

2. Abrir conectores personalizados (Custom connectors)

  • Role até a seção Personalizado (Custom) e selecione Conectores personalizados (Custom connectors).

3. Inserir a URL do servidor Wati MCP

  • Na tela Adicionar conector personalizado (Add custom connector), insira a URL do servidor MCP correspondente à região do seu workspace na tabela acima.

4. Escolher Wati

  • Seu navegador abrirá a página de conexão do Wati. Ela indicará que agent.meta.ai deseja conectar-se ao Wati e ao Astra. Selecione Wati e clique em Continuar (Continue).

5. Entrar e autorizar o acesso

  • Na página de login do Wati, entre com sua conta Wati existente. Revise a solicitação de autorização e aprove o acesso para concluir a conexão.

Você não precisa criar uma nova conta ou gerar uma chave de API.

6. Começar a usar o Wati no Muse

  • Assim que a conexão for concluída, peça ao Muse para realizar tarefas suportadas em seu workspace Wati usando linguagem natural.

Parte 2: Conectar o Wati MCP ao Gemini CLI

Você pode conectar o Wati MCP ao Gemini CLI do Google adicionando a configuração do servidor Wati ao seu arquivo de configurações do Gemini CLI. O Gemini CLI usa OAuth para autenticar sua conta Wati através do seu navegador.

O Gemini CLI se conecta a servidores MCP listados em mcpServers no seu arquivo settings.json. A entrada wati usa httpUrl para acessar o servidor Wati MCP via Streamable HTTP, e oauth.enabled permite que o Gemini CLI o autentique através do navegador, para que você não precise adicionar uma chave de API ao arquivo. Uma vez autorizado, o Gemini CLI descobre as ferramentas Wati disponíveis para sua conta. Para mais opções de configuração, consulte a documentação do servidor MCP do Gemini CLI.

Pré-requisito

Instale o Gemini CLI antes de começar. Siga o guia oficial de instalação e configuração do Gemini CLI.

Etapas para conectar

Dica: Se preferir não editar o JSON, execute o seguinte comando no seu terminal em vez das etapas 1 e 2, e continue a partir da etapa 3:

gemini mcp add --transport http wati <https://mcp.wati.io/mcp>

Para workspaces na UE, use a URL da UE da tabela acima.

1. Abrir o arquivo de configurações do Gemini CLI

  • Abra ~/.gemini/settings.json no seu editor de texto de preferência.

    Se o arquivo não existir, crie-o.

2. Adicionar a configuração do servidor Wati MCP

Em mcpServers, adicione a seguinte configuração:

{
  "mcpServers": {
    "wati": {
      "httpUrl": "https://mcp.wati.io/mcp",
      "oauth": {
        "enabled": true
      }
    }
  }
}

Para workspaces na UE, use a URL da UE da tabela acima.

Se o seu arquivo de configurações já contiver outros servidores MCP, adicione a entrada wati dentro do objeto mcpServers existente. Mantenha a configuração existente intacta e garanta que a sintaxe JSON seja válida.

3. Reiniciar o Gemini CLI

  • Feche e reinicie o Gemini CLI para que ele carregue a configuração atualizada.

4. Entrar no Wati

  • Ao usar a conexão pela primeira vez, o Gemini CLI abrirá seu navegador para iniciar o fluxo de login OAuth do Wati. Entre com sua conta Wati existente e aprove o acesso solicitado.

5. Retornar ao terminal

  • Assim que a autorização for concluída, retorne ao Gemini CLI e continue usando o servidor Wati conectado.

6. Autenticar novamente, se necessário

  • Se precisar entrar novamente, execute o seguinte comando no Gemini CLI:

/mcp auth wati

7. Verificar a conexão

  • Peça ao Gemini CLI para realizar uma tarefa simples, como:

List my Wati contacts.

Se a conexão e as permissões estiverem configuradas corretamente, o Gemini CLI deve ser capaz de recuperar as informações de contato suportadas do seu workspace Wati.

O que você pode fazer com o Wati MCP?

Dependendo das permissões do seu workspace, plano de produto e canais ativados, você pode usar o Muse ou o Gemini CLI para realizar tarefas como:

  • Contatos: Pesquisar, listar, adicionar e atualizar contatos; gerenciar atributos de contato; visualizar contagens de contatos; e atribuir contatos a equipes.

  • Conversas: Recuperar mensagens, gerenciar tags e status de conversa, atribuir conversas e transferir conversas para um operador.

  • Mensagens: Enviar mensagens de texto e arquivos, usar botões e listas interativas e enviar modelos de mensagem aprovados.

  • Campanhas: Trabalhar com transmissões, visualizar estatísticas de campanha, estimar custos de envio e verificar créditos disponíveis.

  • Configuração do workspace: Gerenciar segmentos suportados, canais, webhooks e modelos de mensagem.

  • Instagram: Usar fluxos de trabalho do Instagram suportados onde o recurso está ativado para o seu workspace.

Exemplos de prompts

Após conectar o Wati a qualquer um dos clientes, tente perguntar:

  • "Find every conversation tagged billing from last week."

  • "Send the order_update template to contacts in the VIP Customers segment."

  • "How many contacts do we have?"

  • "Show me the latest messages in conversations assigned to my team."

Estes são exemplos de fluxos de trabalho suportados. As ações disponíveis dependem da sua conta e da configuração do seu workspace.

Solução de problemas e notas importantes

Tenha em mente os seguintes pontos ao usar o Wati MCP com qualquer um dos clientes:

  • As ferramentas disponíveis podem variar: As ferramentas disponíveis para sua conta são determinadas pela lista de ferramentas do servidor MCP para sua sessão autenticada.

  • As permissões ainda se aplicam: A função no seu workspace Wati, o plano de produto e as permissões de canal determinam quais ações você pode realizar. Uma ferramenta pode estar disponível, mas retornar um erro de permissão ou de plano ao ser utilizada.

  • Use a URL de servidor correta: Certifique-se de usar o endpoint Global ou da UE que corresponde ao seu workspace Wati.

  • Verifique sua configuração: Para o Gemini CLI, confirme se a entrada do servidor está em mcpServers, se a URL está correta e se a sintaxe JSON é válida.

  • Use uma máquina com navegador local (Gemini CLI): O Gemini CLI abre um navegador na mesma máquina para concluir o login OAuth do Wati. Isso não funciona via SSH ou em ambientes headless, como servidores remotos ou contêineres. Execute o Gemini CLI em uma máquina com navegador para entrar.

  • Reautentique se necessário: Se sua sessão exigir renovação de autorização, execute /mcp auth wati no Gemini CLI.

  • Nenhuma chave de API é necessária: Ambas as integrações usam autenticação OAuth, então você não precisa adicionar uma chave de API do Wati à configuração da conexão.

Recursos relacionados

Perguntas Frequentes (FAQs)

FAQs sobre a integração Wati MCP

1. O que é o servidor Wati MCP e para que posso usá-lo?

O servidor Wati Model Context Protocol (MCP) conecta clientes de IA compatíveis, como o Meta Muse e o Gemini CLI do Google, ao seu workspace Wati. Você pode usar linguagem natural para realizar tarefas suportadas, incluindo pesquisar contatos, gerenciar conversas, enviar modelos de mensagem aprovados, visualizar estatísticas de campanha e gerenciar segmentos e webhooks suportados. As ações disponíveis dependem das permissões do seu workspace, do plano de produto e dos canais ativados.

2. Quais planos do Wati suportam MCP e quais clientes de IA posso usar?

O servidor Wati MCP está disponível nos planos Growth, Pro e Business. Contas de teste também podem ativar e usar o servidor durante o período de avaliação. Você pode conectar o Wati ao Meta Muse ou ao Gemini CLI. O Meta Muse está disponível atualmente apenas nos Estados Unidos e Canadá; clientes fora dessas regiões podem usar o Gemini CLI.

3. Qual URL de servidor Wati MCP devo usar?

Use a URL que corresponde à região do seu workspace Wati:

  • Global: https://mcp.wati.io/mcp

  • UE: https://eu-mcp.wati.io/mcp

Use a URL regional apropriada ao configurar seu cliente de IA.

Configuração e Autenticação

4. Como conecto o Wati MCP ao Meta Muse?

No aplicativo Muse, vá para Configurações > Conectores > Conectores personalizados. Insira a URL do servidor Wati MCP para a região do seu workspace. Quando seu navegador abrir a página de conexão do Wati, selecione Wati, clique em Continuar, entre com sua conta Wati existente e aprove o acesso. Uma vez conectado, você pode usar linguagem natural para interagir com seu workspace Wati.

5. Como conecto o Wati MCP ao Gemini CLI?

Primeiro, instale o Gemini CLI. Em seguida, adicione o servidor Wati MCP ao ~/.gemini/settings.json em mcpServers usando a seguinte configuração:

{
  "mcpServers": {
    "wati": {
      "httpUrl": "https://mcp.wati.io/mcp",
      "oauth": {
        "enabled": true
      }
    }
  }
}

Para workspaces na UE, substitua a URL por https://eu-mcp.wati.io/mcp. Salve a configuração e reinicie o Gemini CLI. No primeiro uso, entre no Wati pelo navegador e aprove o acesso.

Alternativamente, adicione o servidor a partir do seu terminal usando:

gemini mcp add --transport http wati https://mcp.wati.io/mcp

Para workspaces na UE, use a URL da UE em vez disso.

6. Preciso de uma chave de API do Wati para conectar um cliente de IA?

Não. Tanto o Meta Muse quanto o Gemini CLI usam autenticação OAuth. Entre com sua conta Wati existente pelo navegador e aprove o acesso. Você não precisa criar uma nova conta Wati ou adicionar uma chave de API à sua configuração.

Solução de problemas e Permissões

7. Como verifico ou reautentico a conexão Wati MCP no Gemini CLI?

Para verificar a conexão, pergunte ao Gemini CLI: "List my Wati contacts." Se precisar autenticar novamente, execute:

/mcp auth wati

Conclua o login baseado no navegador e aprove o acesso quando solicitado.

8. Por que o Gemini CLI não consegue concluir a autenticação OAuth do Wati via SSH ou em um ambiente headless?

O Gemini CLI abre um navegador na mesma máquina onde está sendo executado para concluir o login OAuth do Wati. Este processo não funciona via SSH ou em ambientes headless, como servidores remotos ou contêineres. Execute o Gemini CLI em uma máquina com navegador local para concluir a autenticação.

9. Por que uma ação do Wati MCP retorna um erro ou parece indisponível?

As ferramentas e ações disponíveis dependem da lista de ferramentas Wati MCP para sua sessão autenticada, sua função no workspace, seu plano de produto e suas permissões de canal ativadas. Uma ferramenta pode estar disponível, mas retornar um erro de permissão ou plano ao ser utilizada. Para problemas de conexão com o Gemini CLI, verifique também se a URL do servidor corresponde à região do seu workspace, se a configuração está em mcpServers, se a sintaxe JSON é válida e se o OAuth está ativado.

Artigos relacionados
Respondeu à sua pergunta?