WasenderAPI MCP

Conecte a WasenderAPI a agentes de IA e ferramentas de automação usando o Model Context Protocol. Este servidor MCP remoto expõe gerenciamento de sessão do WhatsApp, mensagens, contatos e grupos como ferramentas acionáveis para plataformas compatíveis com MCP.

Documentação

Conecte a WasenderAPI a agentes de IA e ferramentas de automação usando o Model Context Protocol. Este servidor MCP remoto expõe gerenciamento de sessões do WhatsApp, mensagens, contatos e grupos como ferramentas chamáveis para Claude Code, OpenCode, n8n e outras plataformas compatíveis com MCP. Requer um plano pago e Personal Access Token para autenticação.

Guia de Integração da WasenderAPI MCP

Adicione a WasenderAPI MCP às suas ferramentas favoritas (Claude Code/Desktop/CLI, OpenCode ou n8n) usando seu Personal Access Token.

A integração MCP está disponível apenas em planos pagos. Este recurso não está disponível em contas de teste.

Substitua YOUR_PERSONAL_ACCESS_TOKEN pelo token das configurações da sua conta WasenderAPI. Mantenha-o em segredo.

Claude Code / Desktop / CLI

  1. Certifique-se de que a CLI do Claude esteja instalada e você esteja conectado.
  2. Registre o MCP usando seu token:
claude mcp add --transport http wasenderapi https://wasenderapi.com/mcp \
  --header "Authorization: Bearer YOUR_PERSONAL_ACCESS_TOKEN"
  1. Verifique se ele aparece com claude mcp list e inicie uma nova sessão do Claude Code; as ferramentas da WasenderAPI estarão disponíveis.

OpenCode

  1. Abra sua configuração do OpenCode (o padrão é ~/.config/opencode/config.json).
  2. Cole o trecho de configuração abaixo sob a chave "mcp":
{
  "mcp": {
    "WasenderAPI": {
      "type": "remote",
      "url": "https://wasenderapi.com/mcp",
      "enabled": true,
      "headers": {
        "Authorization": "Bearer YOUR_PERSONAL_ACCESS_TOKEN"
      }
    }
  },
  "$schema": "https://opencode.ai/config.json"
}
  1. Reinicie ou recarregue o OpenCode. A WasenderAPI MCP aparecerá como WasenderAPI.

Se você já tiver outras entradas MCP, basta adicionar o bloco "WasenderAPI" junto a elas.

n8n (Nó de Ferramenta de Cliente MCP)

Requer n8n v2.0 ou posterior. O n8n inclui um nó de ferramenta MCP que pode chamar servidores MCP externos.

  1. Instale/atualize para n8n v2.0+
  2. Crie um novo workflow e adicione o nó MCP Client Tool.
  3. Configure o endpoint MCP: https://wasenderapi.com/mcp.
  4. Adicione o cabeçalho Authorization: Bearer YOUR_PERSONAL_ACCESS_TOKEN.
  5. Escolha a ferramenta desejada (ex.: send-message, contacts, groups).
  6. Execute o nó; o n8n chamará a ferramenta MCP e retornará a resposta.

Certifique-se de que sua sessão da WasenderAPI esteja conectada e o token seja válido antes de executar.

Ferramentas Disponíveis (MCP)

A WasenderAPI MCP expõe as seguintes ferramentas para agentes de IA:

Gerenciamento de Sessões

  • list_whatsapp_sessions – Recupera todas as sessões do WhatsApp com paginação.
  • get_specific_whatsapp_session – Recupera detalhes de uma sessão específica por ID.
  • get_session_user – Obtém informações sobre o usuário do WhatsApp associado a uma sessão.
  • create_whatsapp_session – Cria uma nova sessão do WhatsApp.
  • update_whatsapp_session – Atualiza uma sessão específica do WhatsApp.
  • connect_whatsapp_session – Inicia/conecta uma sessão do WhatsApp (retorna código QR se necessário).
  • disconnect_whatsapp_session – Desconecta uma sessão do WhatsApp.
  • get_message_logs – Recupera logs de mensagens de uma sessão específica.
  • get_session_logs – Recupera logs de sessão de uma sessão específica.

Mensagens

  • send_text_message – Envia uma mensagem de texto por meio de uma sessão especificada.
  • send_mention_text_message – Envia uma mensagem de texto com menções.
  • send_image_message – Envia uma mensagem de imagem pelo WhatsApp.
  • send_audio_message – Envia uma mensagem de áudio (nota de voz ou arquivo de áudio).
  • send_video_message – Envia uma mensagem de vídeo pelo WhatsApp.
  • send_document_message – Envia um documento/arquivo pelo WhatsApp.
  • send_location_message – Envia uma mensagem de localização pelo WhatsApp.
  • send_contact_message – Envia um cartão de contato pelo WhatsApp.
  • send_poll_message – Envia uma enquete pelo WhatsApp.
  • send_presence_update – Envia uma atualização de presença (disponível, indisponível, digitando, gravando, pausado).
  • resend_message – Reenvia uma mensagem do WhatsApp que falhou.
  • edit_message – Edita uma mensagem existente do WhatsApp.
  • delete_message – Exclui uma mensagem do WhatsApp.
  • get_message_info – Obtém informações sobre uma mensagem específica (status de entrega, recibos de leitura).

Contatos

  • list_contacts – Lista todos os contatos do WhatsApp de uma sessão especificada.
  • add_or_edit_contact – Adiciona um novo contato ou edita um contato existente no WhatsApp.
  • get_contact_info – Obtém informações sobre um contato específico do WhatsApp.
  • get_contact_picture – Obtém a URL da foto de perfil de um contato do WhatsApp.
  • block_contact – Bloqueia um contato do WhatsApp.
  • unblock_contact – Desbloqueia um contato do WhatsApp.
  • check_jid_on_whatsapp – Verifica se um número de telefone/JID existe no WhatsApp.
  • get_lid_from_phone_number – Obtém o LID (Linked Device ID) para um determinado número de telefone.
  • get_phone_number_from_lid – Obtém o número de telefone para um determinado LID.
  • search_contacts – Pesquisa contatos do WhatsApp por nome ou número de telefone.

Grupos

  • list_groups – Lista todos os grupos do WhatsApp de uma sessão especificada.
  • create_group – Cria um novo grupo do WhatsApp com nome e participantes especificados.
  • get_group_metadata – Obtém metadados de um grupo específico (nome, descrição, participantes).
  • get_group_participants – Obtém os participantes de um grupo específico do WhatsApp.
  • add_group_participants – Adiciona participantes a um grupo do WhatsApp.
  • remove_group_participants – Remove participantes de um grupo do WhatsApp.
  • update_group_participants – Promove ou rebaixa participantes em um grupo do WhatsApp.
  • update_group_settings – Atualiza configurações de um grupo do WhatsApp (assunto, descrição, modo de anúncio, etc.).
  • leave_group – Sai de um grupo do WhatsApp.
  • generate_invite_link – Gera um link de convite para um grupo do WhatsApp.
  • accept_group_invite – Aceita um convite de grupo do WhatsApp por código.
  • search_groups – Pesquisa grupos do WhatsApp por nome.

Documentação

  • get_api_documentation_tool – Obtém a documentação da API. Retorna o índice de todas as APIs se nenhum ID for fornecido, ou documentação detalhada para uma entrada específica.

Exemplos de Código

json

{
  "mcp": {
    "WasenderAPI": {
      "type": "remote",
      "url": "https://wasenderapi.com/mcp",
      "enabled": true,
      "headers": {
        "Authorization": "Bearer YOUR_PERSONAL_ACCESS_TOKEN"
      }
    }
  }
}