Sua ponte definitiva entre WhatsApp, Chatwoot, Hermes Agent e MCP
Conecte múltiplos provedores de WhatsApp a destinos como Chatwoot e Hermes Agent. Gerencie contatos com Claude/Codex via MCP e aproveite nossa API Interna.
Vantagens imbatíveis com o API Connector
Tudo o que você precisa para conectar WhatsApp a múltiplos destinos e agentes de IA.
Múltiplos Destinos
Envie suas mensagens do WhatsApp para o Chatwoot ou de forma nativa para o Hermes Agent.
Integração MCP Nativa
Gerencie conversas e contatos diretamente de agentes de IA como Claude Cowork e Codex.
API Interna Própria
Envie e receba mensagens com facilidade usando chamadas HTTP diretas e simplificadas.
Estabilidade Robusta
Processamento assíncrono com filas Redis garantindo zero perda de mensagens.
Integre Simples, Escale para Milhões
Conecte instâncias de WhatsApp em minutos. Nossa infraestrutura garante estabilidade total integrando com Chatwoot, Hermes Agent e ferramentas de IA (MCP).
- Roteamento de mensagens para Chatwoot e Hermes Agent
- Servidor MCP integrado para Claude e Codex (OAuth/Bearer)
- API interna própria para testes e envios rápidos
- Integração Multi-API Plug & Play (Z-API, W-API, Whapi)
- Processamento assíncrono com fila Redis resiliente
Por que escolher o API Connector?
Liberdade de Escolha de API
Conecte múltiplos provedores em segundos. Alterne entre Z-API, W-API, Whapi ou nossa API Interna de forma transparente sem alterar nenhuma linha de código.
Anti-Ban Inteligente
Evite bloqueios e banimentos no WhatsApp. Integração com APIs profissionais que utilizam proxies e IPs residenciais dedicados para garantir a máxima segurança dos seus números.
Monitore via Claude
Consulte o status da fila de envio, a integridade dos conectores e o histórico de mensagens conversando diretamente com a IA pelo Claude ou Codex.
Automações Inteligentes
Conecte agentes autônomos de IA do Claude ou Codex ao seu WhatsApp. Graças à integração nativa com o protocolo MCP, seu agente pode ler e responder mensagens no WhatsApp.
Fluxo de Mensagens
Recepção
O webhook recebe a mensagem do provedor escolhido.
Normalização
O Adapter converte o payload para o formato padrão do sistema.
Fila Redis
A mensagem é enfileirada para garantir alta performance.
Entrega
O processador cria/busca o contato e entrega a mensagem no Chatwoot.
Arquitetura do Sistema
Conectores (WhatsApp)
Z-API, W-API, Whapi
API Interna
Conexão via QR Code
API Connector
Normalização & Fila Redis
Servidor MCP
Roteamento direto para Conectores ou Chatwoot
Chatwoot
Inbox & Atendimento Humano
Hermes Agent
Agente de IA Autônomo
Instalação Rápida
Suba sua instância com Docker puro, Portainer/Traefik ou EasyPanel. As stacks já vêm alinhadas para backend, frontend, WhatsApp e MCP na mesma versão.
Ver Guia Completo de Instalação→# docker-compose.yml
services:
redis:
image: redis:7-alpine
container_name: api-connector-redis
restart: unless-stopped
volumes:
- redis_data:/data
networks:
- connector_net
healthcheck:
test: [ "CMD", "redis-cli", "ping" ]
interval: 5s
timeout: 3s
retries: 5
api:
image: registry.gitlab.com/andrealencar/chatwoot-api-connector/api_connector_backend:1.4.1.29
container_name: api-connector-api
restart: unless-stopped
ports:
- "3000:3000"
environment:
- NODE_ENV=production
- DATABASE_URL=file:/app/data/database.db
- REDIS_HOST=redis
- REDIS_PORT=6379
- PORT=3000
- MCP_OAUTH_CLIENT_ID=api-connector-claude
- JWT_SECRET=${JWT_SECRET:-supersecretkey}
- JWT_REFRESH_SECRET=<defina_na_stack>
- ENCRYPTION_KEY=<defina_na_stack>
volumes:
- api_data:/app/data
- api_logs:/app/logs
depends_on:
redis:
condition: service_healthy
networks:
- connector_net
frontend:
image: registry.gitlab.com/andrealencar/chatwoot-api-connector/api_connector_frontend:1.4.1.29
container_name: api-connector-frontend
restart: unless-stopped
ports:
- "80:80"
depends_on:
- api
networks:
- connector_net
baileys:
image: registry.gitlab.com/andrealencar/chatwoot-api-connector/api_connector_baileys:1.4.1.30
container_name: api-connector-baileys
restart: unless-stopped
ports:
- "8080:8080"
environment:
- WEBHOOK_URL=http://api:3000/api/webhooks/baileys
- PUBLIC_URL=http://localhost:8080
volumes:
- baileys_data:/data
depends_on:
- api
networks:
- connector_net
mcp:
image: registry.gitlab.com/andrealencar/chatwoot-api-connector/api_connector_mcp:1.4.1.29
container_name: api-connector-mcp
restart: unless-stopped
ports:
- "3100:3100"
environment:
- API_BASE_URL=http://api:3000
- API_TOKEN=${JWT_SECRET:-supersecretkey}
- MCP_OAUTH_CLIENT_ID=api-connector-claude
- MCP_OAUTH_REDIRECT_URIS=http://127.0.0.1:4391/callback,http://localhost:4391/callback,https://claude.ai/api/mcp/auth_callback
- MCP_OAUTH_STATE_PATH=/app/data/mcp-oauth-state.json
volumes:
- mcp_data:/app/data
depends_on:
- api
networks:
- connector_net
networks:
connector_net:
driver: bridge
volumes:
redis_data:
api_data:
api_logs:
baileys_data:
mcp_data:Imagens GHCR
Fixamos tags da release estável disponível no nosso registro oficial.
Segurança
Credenciais sensíveis já embutidas. Menos exposição de variáveis no seu servidor.
Bateria Inclusa
Redis, Database SQLite e Healthchecks configurados para máxima disponibilidade.
Preços Transparentes
Taxa única anual para qualquer quantidade de Mensagens