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
- Certifique-se de que a CLI do Claude esteja instalada e você esteja conectado.
- Registre o MCP usando seu token:
claude mcp add --transport http wasenderapi https://wasenderapi.com/mcp \
--header "Authorization: Bearer YOUR_PERSONAL_ACCESS_TOKEN"
- Verifique se ele aparece com
claude mcp liste inicie uma nova sessão do Claude Code; as ferramentas da WasenderAPI estarão disponíveis.
OpenCode
- Abra sua configuração do OpenCode (o padrão é
~/.config/opencode/config.json). - 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"
}
- 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.
- Instale/atualize para n8n v2.0+
- Crie um novo workflow e adicione o nó MCP Client Tool.
- Configure o endpoint MCP:
https://wasenderapi.com/mcp. - Adicione o cabeçalho
Authorization: Bearer YOUR_PERSONAL_ACCESS_TOKEN. - Escolha a ferramenta desejada (ex.: send-message, contacts, groups).
- 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"
}
}
}
}