Pular para o conteúdo

Agente de IA com API de WhatsApp: REST, MCP e webhooks sem falar direto com a Meta

Se você é desenvolvedor, não precisa montar a integração com a Meta nem manter um servidor de mensagens: o Cordex cuida do WhatsApp e expõe o que importa por API REST, MCP e webhook.

Começar teste grátis

7 dias grátis com 3.000 créditos. Sem cartão.

Ver a conversa em texto
  1. Loja Vento Sul, Agente: Avisos de entrega
  2. Agente: Oi, Letícia! O pedido 4821 saiu para entrega hoje. Posso te avisar quando o motorista estiver perto?
  3. Cliente: Pode. Chega até que horas?
  4. Agente: A transportadora prevê até as 18h. Se ninguém puder receber, responda aqui que a gente reagenda com ela.
  5. Cliente: Ok, vou estar em casa.

Do seu sistema ao WhatsApp em quatro passos

  1. 1

    Gere uma chave de API

    Em Configurações, na aba API e MCP, crie uma chave cdx_ com os escopos de que o seu código precisa. Na API REST v1, o OpenAPI e as docs públicas descrevem cada operação.

  2. 2

    Mande eventos por webhook

    Crie uma automação com gatilho de webhook de entrada. Quando o seu sistema chama a URL, a automação roda e pode acionar um agente ou enviar um template.

  3. 3

    Chame o seu sistema de dentro do fluxo

    Num fluxo, uma ação de requisição HTTP consulta ou grava no seu back-end, e a resposta vira variável para a próxima mensagem.

  4. 4

    Conecte um cliente MCP

    O servidor MCP remoto aceita OAuth, usado pelo Claude.ai e pelo ChatGPT, ou chave de API. O assistente passa a operar o Cordex com as mesmas operações da interface.

O que muda quando o WhatsApp vira API

  • As regras da Meta continuam valendo

    Pela API do Cordex você também respeita a janela de 24 horas: fora dela, a conversa recomeça com um template aprovado. O Cordex não contorna isso.

  • Mesmas operações da interface

    Tudo o que a tela faz tem uma operação equivalente, e o Copiloto usa o mesmo conjunto. A documentação mostra descrição e esquema de cada uma.

  • Escopos por módulo

    A chave e o app OAuth recebem escopos por módulo, como conversas ou contatos. Dê a cada integração só o acesso de que ela precisa.

Dúvidas de quem vai integrar

Preciso de conta de desenvolvedor na Meta?
Para o uso pela API do Cordex, não. A conexão do número é feita pelo cadastro embutido da Meta, dentro da tela Canais.
Existe documentação pública?
Sim: OpenAPI em /api/v1/openapi.json e documentação em /api/v1/docs, com a descrição e o esquema de cada operação.
O agente consegue consultar o meu sistema durante a conversa?
Consegue, por requisição HTTP num fluxo ou por um app conectado. Cada ação do app custa créditos do plano.
Dá para gerenciar chaves pela própria API?
Não. A criação de chaves e de apps OAuth fica só na interface, de propósito, para nenhuma integração conseguir se dar mais acesso.
O n8n tem app próprio?
Não. Ele se liga pelo webhook de entrada das automações, pela requisição HTTP dos fluxos ou pela API REST e MCP.
Como o meu sistema fica sabendo de uma mensagem nova?
Os eventos de mensagem, conversa e pagamento disparam automações, e uma automação pode chamar uma URL sua por requisição HTTP. A API também lista as conversas e mensagens quando você precisar consultar.
Posso criar agentes e fluxos pela API?
Pode: as operações que a interface faz, como criar fluxos, contatos e negócios, estão expostas. A lista completa aparece nas docs, sem as que exigiriam mexer em chaves.
O Claude ou o ChatGPT conseguem operar o Cordex?
Sim, pelo servidor MCP remoto com login OAuth. O assistente enxerga as operações liberadas pelos escopos que você aprovar na tela de autorização.

Preço claro, em reais. Comece grátis.

Todo plano começa com 7 dias grátis. Sem taxa de implantação. Pague com cartão, boleto ou Pix.

Início

Para começar a atender com IA.

R$ 197/mês

  • 2 canais
  • 3 usuários
  • 2 agentes de IA
  • 15.000 créditos por mês

≈ 7.500 respostas de agente no modelo padrão

Escala

Para operações com muitos agentes.

R$ 997/mês

  • 5 canais
  • 25 usuários
  • Agentes de IA ilimitados
  • 120.000 créditos por mês

≈ 60.000 respostas de agente no modelo padrão

Ver tudo que está incluído
Em todos os planos: Copiloto Cordex, inbox com transbordo, fluxos visuais, CRM, campanhas, automações, relatórios, API e MCP. O canal Web é grátis em todos.

Créditos pagam a IA e as integrações. Renovam todo mês.

Com o modelo padrão, uma resposta custa cerca de 2 créditos: 15.000 créditos rendem cerca de 7.500 respostas. Modelos mais econômicos rendem mais; Claude Sonnet e pedidos ao Cordex gastam mais.

  • Campanhas e respostas da sua equipe não gastam créditos.
  • Precisa de mais? Pacotes a partir de 10.000 créditos por R$ 200, válidos por 12 meses.

No teste: 2 canais, 3 usuários, 2 agentes e 3.000 créditos por 7 dias.

Quer ajuda para escolher? Falar no WhatsApp. Quem responde é o nosso agente de IA.

O que são créditos e quantos vou gastar?
Créditos pagam a IA. Com o modelo padrão, uma resposta de agente custa cerca de 2 créditos, então o plano Início rende cerca de 7.500 respostas por mês. Modelos mais econômicos rendem mais; modelos mais avançados custam mais. Campanhas e respostas da equipe não gastam. Os créditos renovam todo mês e você pode comprar pacotes extras. Se acabarem, o agente passa as conversas para sua equipe.
Preciso de cartão para testar? E depois dos 7 dias?
Não pede cartão. Você tem 7 dias e 3.000 créditos com 2 canais, 3 usuários e 2 agentes. Para continuar, escolha um plano e pague com cartão, boleto ou Pix.
Quem paga as mensagens do WhatsApp?
As tarifas de conversa da Meta são cobradas na sua conta Meta, fora dos créditos do Cordex.

Seu próximo cliente já está digitando.

Conecte um canal, descreva seu agente e veja a primeira resposta hoje.

Descreva seu negócio em uma frase. O Cordex monta seu primeiro agente.Começar teste grátis

7 dias grátis com 3.000 créditos. Sem cartão.

Prefere conversar?Falar no WhatsAppQuem responde é o nosso agente de IA.

7 dias grátis

Começar teste grátis