WhatsApp消息管理服务

Zappaz MCP Server是一个连接MCP工具和WhatsApp API的服务,用于发送和管理多种类型的消息(文本、图像、视频、音频、文档、联系人和位置)。

  • by ellion-agency
  • Python
  • 云端部署
  • 2 星标
  • 更新于
在 GitHub 查看 viiniolliveira/zappaz-mcp

使用说明

Zappaz MCP Server

O Zappaz MCP Server conecta ferramentas MCP a Zappaz API de WhatsApp. Ele expoe tools para envio e gerenciamento de mensagens (texto, imagem, video, audio, documento, contato, localizacao) usando um sessionId e um token de sessao.

Casos de uso

  • Envio de mensagens via WhatsApp a partir de agentes MCP.
  • Automacao de atendimentos com multimidia (imagem, video, audio, documento).
  • Compartilhamento de contatos e localizacoes.
  • Remocao de mensagens pelo id.

Servidor Zappaz MCP (Remoto)

O servidor e remoto e esta disponivel em https://mcp.zappaz.io.


Autenticacao

Todas as chamadas exigem:

  • sessionId no query string (?sessionId=...)
  • Authorization no header

Sem esses valores o servidor retorna erro.


Configuracao no OpenCode

Adicione o servidor no seu opencode.json do OpenCode:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "zappaz-mcp": {
      "type": "remote",
      "enabled": true,
      "url": "https://mcp.zappaz.io/mcp?sessionId=YOUR_SESSION",
      "headers": {
        "Authorization": "YOUR_SESSION_TOKEN"
      }
    }
  }
}

Configuracao no Cursor

Crie o arquivo .cursor/mcp.json com a entrada abaixo:

{
  "mcpServers": {
    "zappaz-mcp": {
      "type": "remote",
      "enabled": true,
      "url": "https://mcp.zappaz.io/mcp?sessionId=YOUR_SESSION",
      "headers": {
        "Authorization": "YOUR_SESSION_TOKEN"
      }
    }
  }
}

Configuracao no Antigravity

No Agent Panel, clique nos tres pontos no canto superior direito e selecione MCP Servers. Clique em Manage MCP Servers. Selecione "View raw config" e adicione:

{
  "mcpServers": {
    "zappaz-mcp": {
      "type": "remote",
      "enabled": true,
      "serverUrl": "https://mcp.zappaz.io/mcp?sessionId=YOUR_SESSION",
      "headers": {
        "Authorization": "YOUR_SESSION_TOKEN"
      }
    }
  }
}

Configuracao no VS Code

Abra a Command Palette (Cmd+Shift+P) e digite "MCP: Add Server". Selecione "Add MCP Server". Escolha HTTP para adicionar um MCP remoto. Informe a URL https://mcp.zappaz.io/mcp?sessionId=YOUR_SESSION e o nome zappaz-mcp.

Depois, edite o mcp.json para adicionar o header de autorizacao:

{
  "servers": {
    "zappaz-mcp": {
      "type": "remote",
      "enabled": true,
      "url": "https://mcp.zappaz.io/mcp?sessionId=YOUR_SESSION",
      "headers": {
        "Authorization": "YOUR_SESSION_TOKEN"
      }
    }
  }
}

Configuracao no Claude Desktop

Adicione o servidor no seu arquivo de configuracao MCP:

{
  "servers": {
    "zappaz-mcp": {
      "type": "remote",
      "enabled": true,
      "url": "https://mcp.zappaz.io/mcp?sessionId=YOUR_SESSION",
      "headers": {
        "Authorization": "YOUR_SESSION_TOKEN"
      }
    }
  }
}

Configuracao no Claude Code

Adicione o servidor no seu arquivo de configuracao MCP:

{
  "servers": {
    "zappaz-mcp": {
      "type": "remote",
      "enabled": true,
      "url": "https://mcp.zappaz.io/mcp?sessionId=YOUR_SESSION",
      "headers": {
        "Authorization": "YOUR_SESSION_TOKEN"
      }
    }
  }
}

Configuracao no Windsurf

Adicione o servidor no seu arquivo de configuracao MCP:

{
  "servers": {
    "zappaz-mcp": {
      "type": "remote",
      "enabled": true,
      "url": "https://mcp.zappaz.io/mcp?sessionId=YOUR_SESSION",
      "headers": {
        "Authorization": "YOUR_SESSION_TOKEN"
      }
    }
  }
}

Tools disponiveis

Tool de Mensagens

Tool Descricao
send_text_message Envia mensagem de texto.
send_image_message Envia mensagem de imagem.
send_video_message Envia mensagem de video.
send_audio_message Envia mensagem de audio.
send_document_message Envia mensagem de documento.
send_contact_message Envia mensagem com contato.
send_location_message Envia mensagem com localizacao.
delete_message Deleta uma mensagem por id.

Tool de Grupos

Tool Descricao
list_groups Lista todos os grupos da sessao.
get_group_participants Lista os participantes de um grupo.
create_group Cria um novo grupo.
add_participants Adiciona participantes a um grupo.
remove_participants Remove participantes de um grupo.
promote_participants Promove participantes a administradores.
demote_participants Rebaixa administradores a membros.
send_group_invite_link Envia o link de convite de um grupo.
update_group Atualiza nome, descricao e configuracoes do grupo.
update_group_picture Atualiza a foto do grupo.

Tool de Webhooks

Tool Descricao
get_webhooks Obtem a lista de webhooks configurados para uma sessao.
create_webhook Cria um novo webhook para uma sessao.
update_webhook Atualiza um webhook existente para uma sessao.
delete_webhook Deleta um webhook existente para uma sessao.

Observacoes

  • O token e o sessionId sao obrigatorios para todas as chamadas.