Se você estiver trabalhando com a CLI Codex da OpenAI e precisar que seu agente leia e responda a mensagens do WhatsApp Business, basta adicionar o Aurora MCP ao seu arquivo. ~/.codex/config.tomlAurora expõe um servidor MCP em https://developers.aurorainbox.com/mcp Com mais de 30 ferramentas (pesquisar chats, enviar mensagens, criar contatos, mover oportunidades, registrar webhooks) que o Codex utiliza nativamente, 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 bloco de 5 linhas em TOML. Este guia abrange a configuração completa.
Pré-requisitos
Antes de mexer na configuração, certifique-se de que você tem:
- Espaço de trabalho Aurora Inbox ativo (o teste grátis Serve para validar todo o fluxo.
- Número do WhatsApp Business conectado No Aurora (via OAuth com Meta ou registro manual).
- Codex CLI instalado:
npm install -g @openai/codexou o instalador comcachosFornecido pela OpenAI. Verifique comcodex --versão. - Conta OpenAI com acesso ao GPT-5 ou outro modelo da série ou conectado ao Codex (
Login do Codex). - API da plataforma principal
ak_live_*gerado no Portal do Desenvolvedor Aurora (próximo passo).
A CLI do Codex funciona em macOS, Linux e Windows (WSL2 recomendado). O arquivo de configuração TOML sempre reside em ~/.codex/config.toml.
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,
codex-cli-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 Codex é feita usando a identidade do seu espaço de trabalho e é registrada no log de auditoria. ID da chave que deu origem a isso.
Etapa 2: Adicione o Aurora MCP ao Codex
Abrir ~/.codex/config.toml (Crie-o se não existir) e adicione este bloco:
[mcp_servers.aurora] url = "https://developers.aurorainbox.com/mcp" transport = "http" [mcp_servers.aurora.headers] Authorization = "Bearer ak_live_REEMPLAZA_TU_CLAVE"
O nome aurora É arbitrário — é assim que o Codex se referirá ao servidor internamente. Se você gerencia vários espaços de trabalho, pode se registrar. aurora-prod e aurora-encenação com suas respectivas chaves.
Se preferir não editar o TOML manualmente, o Codex CLI oferece um atalho:
codex mcp add aurora \ --url https://developers.aurorainbox.com/mcp \ --header "Authorization: Bearer ak_live_REEMPLAZA_TU_CLAVE"
Verifique se foi gravado:
Lista Codex MCP
Você deveria ver aurora com estado conectado e a lista de ferramentas disponíveis. Se aparecer fracassadoVerifique se a chave está completa, sem espaços extras, e se começa exatamente com ak_live_.
Passo 3: Teste a conexão
Abra o Codex CLI em qualquer diretório e peça para ele executar algo simples:
Liste os 5 primeiros contatos da minha conta Aurora Inbox.
Codex vai chamar a ferramenta de lista_contatos e retornar uma matriz com eu ia, inhame, telefone, e-mail, nome da empresaSe a resposta vier com dados reais do seu ambiente de trabalho, a configuração funciona e você pode passar para perguntas mais interessantes.
Dica: Na primeira vez que usar o Codex, ele poderá solicitar confirmação antes de invocar cada nova ferramenta MCP. Aceite e, opcionalmente, marque a opção "sempre permitir" para ferramentas idempotentes, como... lista_contatos qualquer pesquisar_chats.
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_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 | Ferramentas da empresa para listar, consultar e editar. | 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 (HTTPS, máximo de 5 inquilinos, a chave secreta é exibida apenas uma vez), lista_webhooks |
Eventos de saída para sua infraestrutura |
| Diagnóstico | saúde, quem sou eu |
Validar conectividade e permissões |
O tipoDeCanal que aceitam criar_chat e as ferramentas relacionadas são: 0 = API do WhatsApp Cloud, 1=WhatsApp Business, 2=Mensageiro, 3=Instagram. criar_contato requer inhame e telefone; upsert_contact é indexado por telefone.
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.
O Codex exige pesquisar_chats(não respondido=verdadeiro) e então obter_chat(id) Para cada um deles, você recebe uma lista priorizada em linguagem natural, pronta para o agente humano começar o dia.
Entre em contato e abra oportunidades.
Tenho uma nova lead: Daniela Pérez, +52 81 9876 5432, daniela@empresa.mx, empresa "Distribuidora Norte". Crie essa lead no Aurora e abra uma oportunidade no funil de vendas "Q3 Sales" da equipe de vendas com um valor estimado de $120.000 MXN.
Correntes do Codex upsert_contact → criar_chat (Canal do WhatsApp Cloud) → criar_oportunidade → atualizar_oportunidade(valorDoNegócio=120000)Tudo a partir do terminal, sem precisar abrir a interface do Aurora.
Acompanhamento massivo
Procure por chats não respondidos de clientes com mais de 72 horas. Envie a cada um deles 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 Codex respeita automaticamente o limite de taxa de enviar_mensagem (1 mensagem/segundo por locatário). Se exceder esse limite, você receberá Limite de requisições excedido… tente novamente em 1 segundo e para por si só.
Solução de problemas
Erro 401 Não autorizado
A chave não foi colada completamente ou contém espaços ou quebras de linha. Gere-a novamente e cole-a cuidadosamente dentro das aspas duplas do TOML. Lembre-se: a chave deve começar exatamente com ak_live_Ao copiar do Portal do Desenvolvedor, evite selecionar o espaço que às vezes sobra no final.
Erro 403: Proibido em ferramentas específicas
Algumas ferramentas exigem funções adicionais. Por exemplo, excluir_contato Você precisa da função de Administrador de Contatos. Verifique as funções de usuário associadas à chave em Integrações → Portal do desenvolvedor → PermissõesA chave herda as permissões do usuário que a gerou.
As ferramentas não aparecem em Lista Codex MCP
Reinicie sua sessão do Codex (saia com saída e aberto códice (Novamente) — os servidores MCP são carregados na inicialização. Se o problema persistir, verifique se o endpoint está respondendo:
curl https://developers.aurorainbox.com/.well-known/mcp.json
Deverá retornar um JSON com versão do protocolo: "2025-03-26" e transporte: "streamable-http".
Limite de taxa em enviar_mensagem
Aurora limita o envio a 1 mensagem por segundo por locatário para proteger a qualidade dos números no Meta. Se o seu agente precisar enviar 100 mensagens, sequencie-as com um atraso de 1 segundo (o Codex faz isso automaticamente ao detectar o cabeçalho de nova tentativa) ou use /Plataforma/V1/Mensagens/Em massa via REST (não exposto via MCP por design).
Como o Aurora MCP faz isso
Ao contrário de colar diretamente a API WhatsApp Cloud em uma chamada de função do OpenAI, o Aurora MCP oferece:
- Autenticação simples: uma chave
ak_live_*Reutiliza o mesmo sistema de API da plataforma. Sem OAuth de três etapas, sem tokens que expiram a cada hora. - Registro de auditoria nativoCada chamada é gravada no Aurora com o
ID da chaveque deu origem a isso. Você sabe qual máquina e qual desenvolvedor executaram cada ação. - Limites de tarifa por inquilinoSeu agente não pode degradar a qualidade dos números em Meta enviando dados muito rapidamente; o Aurora aplica limitação de taxa antes de acessar Meta.
- MulticanalA mesma ferramenta funciona para a API do 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 aleatória".
Plano recomendado para começar a usar o Codex com o Aurora: Aurora IA $179 USD/mês ($3.200 MXN) que inclui GPT-5, RAG nativo, agendamento integrado e servidor MCP irrestrito.
Comece seu teste gratuito e conectar o Codex CLI 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 / $1.800 MXN, IA $179 USD / $3.200 MXN, IA Plus $329 USD / $6.000 MXN). O período de teste de 14 dias também o inclui, sem restrições ou necessidade de cartão de crédito.
O Codex CLI funciona no macOS, Linux e Windows?
Sim. O binário possui versões nativas para macOS (Intel + Apple Silicon), Linux x64/arm64 e Windows. No Windows, a OpenAI recomenda o WSL2 para melhor compatibilidade com shells e ferramentas de desenvolvimento. O arquivo ~/.codex/config.toml Ele fica localizado na pasta HOME do usuário do Codex em qualquer plataforma.
Minha chave está visível nos logs da CLI do Codex?
Cabeçalhos de máscaras Codex Autorização em seu log de depuração padrão. Mesmo assim, ele tenta. ak_live_* como senha — não a inclua no Git, não a cole em problemas públicos. O arquivo ~/.codex/config.toml Você precisa ter autorizações. 600 (chmod 600 ~/.codex/config.toml no macOS/Linux).
O Aurora suporta multi-tenant no Codex?
Cada chave é vinculada a um único locatário. Se você gerencia vários espaços de trabalho Aurora (cliente A, cliente B, seu próprio ambiente de teste), gere uma chave por espaço de trabalho e registre cada um como um servidor MCP separado no TOML. [mcp_servers.aurora-clienteA], [mcp_servers.aurora-clienteB]O Codex permitirá que você escolha ou invoque o correto pelo nome.
O que acontece se a OpenAI ou a Anthropic atualizarem o protocolo MCP?
Aurora suporta a versão 2025-03-26 (a especificação estável adotada pela OpenAI e pela Anthropic) sobre transporte streamable-httpAs versões futuras são adicionadas, mantendo a compatibilidade com versões anteriores, de acordo com o especificação oficialVocê não precisa alterar sua configuração quando enviarmos uma versão secundária.
Posso usar o Codex e outros agentes (Claude Code, Cursor) na mesma conta Aurora?
Sim, simultaneamente. Mesma chave ou chaves separadas — você decide. A mesma instância do Aurora MCP recebe chamadas do Codex, Claude Code, Cursor, Claude Desktop ou qualquer outro cliente compatível sem conflitos. Cada cliente tem uma configuração ligeiramente diferente — consulte nossos guias para obter detalhes. Código Claude, Área de trabalho Claude, Cursor e VS Code CopilotSe você quiser saber mais sobre o protocolo, continue lendo. O que é MCP e como a IA se conecta com o WhatsApp? ou explore 10 casos de uso para agentes no WhatsApp com Aurora MCP.
