Conectar o Claude Code ao WhatsApp Business leva 5 minutos com o Aurora MCP. O Aurora expõe um servidor MCP em https://developers.aurorainbox.com/mcp Com mais de 30 ferramentas (buscar chats, enviar mensagens, criar contatos, conduzir oportunidades pelo funil, lançar webhooks) que qualquer agente compatível com MCP pode usar. Tudo o que você precisa é de um espaço de trabalho do Aurora Inbox e uma chave. ak_live_* a partir do Portal do Desenvolvedor e um comando Claude MCP AdicionarEste guia abrange a configuração do início ao fim.
Pré-requisitos
Antes de executar o comando, certifique-se de que você tem:
- Espaço de trabalho Aurora Inbox ativo (o teste grátis É utilizado para testar todo o fluxo.
- Número do WhatsApp Business conectado No Aurora (via OAuth com Meta ou registro manual).
- Código Claude instalado (
npm install -g @anthropic-ai/claude-codeou o instalador oficial). - API da plataforma principal
ak_live_*gerado no Portal do Desenvolvedor (abaixo).
Passo 1: Gere a chave Aurora
- Entre no seu espaço de trabalho em
app.aurorainbox.com. - Ir para Integrações → Portal do Desenvolvedor (URL direta: https://app.aurorainbox.com/integrations/developer-portal).
- Clique em Gerar nova chaveDê-lhe um nome descritivo (por exemplo,
claude-código-laptop-alex). - Copie a chave — ela começa com
ak_live_…Ele só é exibido uma vez; se você o perder, terá que gerar outro.
A chave está definida para um único locatário (um espaço de trabalho Aurora) com escopo aurora.api.plataformaQualquer ação realizada pelo Claude Code é feita com a sua identidade de espaço de trabalho e é registrada no log de auditoria.
Passo 2: Adicione o Aurora MCP ao código Claude
Um único comando:
claude mcp add aurora \ --transport http \ https://developers.aurorainbox.com/mcp \ --header "Authorization: Bearer ak_live_REEMPLAZA_TU_CLAVE"
Isso adiciona o Aurora à sua configuração de usuário (~/.claude.jsonPara verificar se foi registrado:
Lista Claude MCP
Você deveria ver aurora na lista com status conectadoSe aparecer fracassadoVerifique se a chave está completa e começa com ak_live_.
Passo 3: Teste a conexão
Abra o Claude Code em qualquer projeto e peça a ele para executar algo simples:
Liste os 5 primeiros contatos da minha conta Aurora Inbox.
Claude Code vai chamar a ferramenta. lista_contatos e retornar uma matriz com eu ia, inhame, telefone, e-mail, nome da empresaSe a resposta chegar, a configuração funciona.
Que ferramentas o Aurora MCP oferece?
O Aurora MCP abrange todas as 10 áreas funcionais do produto. Cada ferramenta espelha um endpoint REST da API Platform V1 na mesma proporção.
| Categoria | Ferramentas representativas | Caso de uso |
|---|---|---|
| Bate-papos | pesquisar_chats, obter_bate-papo, criar_chat, atribuir_agentes_de_chat, definir_proprietário_do_chat |
Triagem de bandejas, atribuição de agentes |
| Mensagens | enviar_mensagem (1 ms/s por locatário), notas internas com nota=verdadeiro |
Respostas, acompanhamento e feedback para a equipe. |
| Chatbots | iniciar_chatbot, parar_chatbot, lista_chat_chatbots, lista_chatbots |
Ative fluxos de trabalho em chats específicos. |
| Contatos | lista_contatos, obter_contato, criar_contato, atualizar_contato, upsert_contact, excluir_contato |
CRM básico do agente |
| Empresas | lista_empresas, obter_empresa, criar_empresa, atualizar_empresa |
Contas B2B |
| Oportunidades | criar_oportunidade, oportunidade_de_atualização, excluir_oportunidade, list_chat_oportunidades |
Avançar com os negócios pelo funil de vendas |
| Canais | Liste e analise o status da API WhatsApp Cloud, WhatsApp Business, Messenger e Instagram. | Diagnóstico multicanal |
| Equipamentos/Usuários | Ferramentas para equipes e usuários para convidar, atribuir e consultar. | integração programática |
| Webhooks | criar_webhook, lista_webhooks, excluir_webhook (máx. 5 por inquilino) |
Eventos de saída para sua infraestrutura |
| Diagnóstico | saúde, quem sou eu |
Validar conectividade e permissões |
O Tipo de canal que aceitam criar_chat e os respectivos pontos finais são: 0 = API do WhatsApp Cloud, 1=WhatsApp Business, 2=Mensageiro, 3=Instagram.
Três exemplos de prompts de ponta a ponta
Triagem matinal
Pesquise no Aurora todas as conversas não respondidas do WhatsApp das últimas 24 horas. Para cada uma, leia a última mensagem do cliente e forneça um resumo de uma linha e a prioridade (alta/média/baixa) com base em se a mensagem menciona dinheiro, urgência ou uma reclamação.
Claude Code liga pesquisar_chats(não respondido=verdadeiro) e então obter_chat(id) Para cada um deles, você recebe uma lista priorizada em linguagem natural.
Entre em contato e abra oportunidades.
Tenho um novo lead: Daniel Martínez, +52 55 1234 5678, daniel@empresa.mx, da empresa "Logística MX". Crie um contato com ele no Aurora e abra uma oportunidade no funil de vendas "Q3 Sales" da equipe de vendas, com um valor estimado de $80.000 MXN.
Cadeias de código Claude upsert_contact → criar_chat (Canal do WhatsApp Cloud) → criar_oportunidade → atualizar_oportunidade(valorDoNegócio=80000)Tudo isso dentro da sessão de bate-papo, sem que você precise abrir a interface do Aurora.
Acompanhamento massivo
Procure por conversas com o status "sem resposta do cliente" que tenham mais de 72 horas. Envie a cada uma delas uma mensagem curta e amigável perguntando se ainda precisam de ajuda. Aguarde 1 segundo entre as mensagens para respeitar o limite de mensagens.
O código Claude respeita automaticamente o limite de taxa de enviar_mensagem (1 mensagem/segundo por locatário — se exceder esse limite, receberá) Limite de requisições excedido… tente novamente em 1 segundo e para).
Solução de problemas
Erro 401 Não autorizado
A chave não foi colada completamente ou apresenta falhas. Recrie-a e cole-a com cuidado. A chave deve começar exatamente com ak_live_.
Erro 403: Proibido em ferramentas específicas
Algumas ferramentas exigem funções adicionais (por exemplo, excluir_contato (Requer a função de Administrador de Contatos). Verifique as funções de usuário associadas à chave em Integrações → Portal do desenvolvedor → Permissões.
As ferramentas não aparecem em Lista Claude MCP
Reiniciar o código Claude (Ctrl+C e Claude (novamente). Se persistir, execute curl https://developers.aurorainbox.com/.well-known/mcp.json e verifique se o servidor responde.
Limite de taxa em enviar_mensagem
Aurora limita o envio a 1 mensagem por segundo por locatário para proteger a qualidade dos dados no Meta. Se o seu agente precisar enviar 100 mensagens, sequencie-as com um atraso de 1 segundo ou use o endpoint. /Plataforma/V1/Mensagens/Em massa (não exposto via MCP por projeto).
Como o Aurora MCP faz isso
Ao contrário da conexão direta do endpoint da API WhatsApp Cloud a um agente, o Aurora MCP oferece:
- Autenticação simples: uma chave
ak_live_*Reutiliza o mesmo sistema de API da plataforma que você já tinha. Sem OAuth de três etapas, sem tokens que expiram. - Registro de auditoria nativoCada chamada é gravada no Aurora com o
ID da chaveque deu origem a isso. - Limites de tarifa por inquilinoSeu agente não pode degradar a qualidade do número Meta enviando-o muito rapidamente.
- MulticanalA mesma ferramenta funciona para WhatsApp Cloud, WhatsApp Business, Messenger e Instagram — o agente escolhe o canal com
tipoDeCanal. - CRM por trásCada conversa já está vinculada a um contato e pode gerar oportunidades — não se trata apenas de "enviar uma mensagem".
Plano recomendado para começar: Aurora IA $179 USD/mês ($3.200 MXN) que inclui GPT-5, RAG nativo, agendamento integrado e servidor MCP.
Comece seu teste gratuito e conectar o Claude Code em 5 minutos.
Perguntas frequentes
O Aurora MCP é gratuito?
O servidor MCP está incluído em qualquer plano pago do Aurora Inbox (CRM $99 USD, IA $179 USD, IA Plus $329 USD). O período de avaliação de 14 dias também o inclui sem restrições.
Funciona com o Claude Code no modo CLI e no modo IDE (VS Code/JetBrains)?
Sim. A configuração permanece em ~/.claude.json e aplica-se a todas as superfícies do Código Claude.
Minha chave está visível nos registros do Claude Code?
Claude Code mascara cabeçalhos Autorização em seu log de depuração. Mesmo assim, ele tenta. ak_live_* como senha — não a inclua no git.
Posso fornecer uma chave por agente ou por desenvolvedor?
Sim, recomendado. Ele gera uma chave por pessoa e uma por máquina; revoga chaves individualmente no Portal do Desenvolvedor sem afetar as demais.
É compatível com múltiplos inquilinos?
Cada chave é vinculada a um único locatário. Se você gerencia vários espaços de trabalho do Aurora, gere uma chave por espaço de trabalho e adicione-as com nomes distintos: Claude MCP adiciona Aurora-Prod… e Claude MCP adiciona aurora-staging….
O que acontece se a Anthropic atualizar o protocolo MCP?
Aurora suporta a versão 2025-03-26 (o espectro estável do Antrópico) no transporte streamable-httpVersões futuras serão adicionadas, mantendo a compatibilidade com versões anteriores, de acordo com o especificação oficial.
Posso conectar outros agentes (Codex, Cursor, Claude Desktop) ao mesmo Aurora?
Sim. Mesma chave, mesmo endpoint. Cada cliente tem uma configuração ligeiramente diferente — consulte nossos guias para obter mais informações. Codex CLI, Área de trabalho Claude, Cursor e VS Code Copilot.
