Por Avi
Publicado em 20 de nov. de 2026
Nó de API para chatbot do WhatsApp: como chamar seu back-end, CRM ou mecanismo de IA durante a conversa
Um chatbot que só envia mensagens fixas logo chega a um limite. O nó de API permite que seu bot do WhatsApp chame seu back-end, CRM, gateway de pagamento ou mecanismo de IA durante a conversa, armazene a resposta e siga caminhos diferentes em caso de sucesso ou falha. Aprenda a configurar, testar e usar o recurso, além de conhecer as melhores práticas.
Resumo
- O nó de API permite que seu chatbot do WhatsApp chame um sistema externo (seu back-end, CRM, gateway de pagamento ou mecanismo de IA) enquanto o cliente ainda está conversando.
- O bot envia uma solicitação, aguarda a resposta e decide o que fazer em seguida.
- No Chakra Chat, você configura a API, armazena a resposta em uma variável, seleciona o valor usando um caminho JSON e direciona respostas 2xx para o caminho de sucesso e respostas que não sejam 2xx para o caminho de falha.
- Use esse recurso quando a resposta precisar de dados em tempo real, e não de uma mensagem fixa.
- Você cria um endpoint simples. O Chakra cuida da parte do WhatsApp.
Um cliente manda uma mensagem para seu número do WhatsApp: "Onde está meu pedido?"
Um chatbot básico só pode dizer: "Informe o número do seu pedido e nossa equipe entrará em contato." Depois, uma pessoa acessa um painel, encontra o pedido e digita uma resposta.
Isso funciona com 20 conversas por dia. Mas não dá conta de 2.000.
A solução não é criar um script mais inteligente. É permitir que o bot consulte seus próprios sistemas para encontrar a resposta. É para isso que serve o nó de API.
O que é um nó de API em um chatbot?
Um fluxo de chatbot é uma sequência de etapas (nós): enviar uma mensagem, fazer uma pergunta, encaminhar para uma pessoa e assim por diante. O nó de API é a etapa que se comunica com sistemas externos.
Segundo o Chakra, esse nó permite que seu chatbot chame uma API diretamente e use a resposta em uma etapa posterior do fluxo.
Pense nele como uma ligação que seu bot faz durante a conversa:
- Para quem ele liga: seu back-end, um CRM, um gateway de pagamento, um mecanismo de IA ou qualquer serviço de terceiros com uma API
- O que ele pergunta: "Qual é o status do pedido 4821?" ou "O cupom DIWALI20 é válido?"
- O que ele faz com a resposta: mostra para o cliente, armazena ou seleciona a próxima etapa
Use esse recurso sempre que uma etapa precisar de dados externos em tempo real , em vez de uma mensagem fixa.
Como funciona?
A ideia é simples: solicitação, resposta, decisão.
- O cliente responde. O bot coleta as informações necessárias, como o número do pedido, por meio de um nó de pergunta.
- O nó de API é acionado. Ele envia uma solicitação para sua URL com os dados coletados.
- Seu sistema responde. Ele retorna dados (status do pedido, resultado do cupom ou resposta da IA) e um código de status.
- O bot decide. Uma resposta 2xx segue o caminho de sucesso . Qualquer outra resposta segue o caminho de falha .
- O cliente vê o resultado. Um nó de mensagem mostra o valor armazenado ou o fluxo segue adiante.
Mensagem do cliente
|
Nó de pergunta (coleta o número do pedido)
|
Nó de API ---> Seu back-end / CRM / mecanismo de IA
| |
|<------ resposta ---+
|
2xx? ---- sim ---> Mensagem: "Seu pedido está {{status}}"
|
não ----------> Alternativa: "Vou encaminhar você para nossa equipe"
A conversa nunca sai do WhatsApp. O cliente simplesmente recebe uma resposta rápida e específica.
Para que você pode usar esse recurso?
Sempre que a resposta depender de dados armazenados em outro lugar.
| Caso de uso | O que o bot consulta | O que o cliente recebe |
|---|---|---|
| Status do pedido | Seu sistema de pedidos | "Seu pedido saiu para entrega e chega hoje" |
| Verificação de cupom | Seu sistema de promoções | "Código válido. Você ganhou 20% de desconto" |
| Consulta de cliente | Seu CRM | Uma saudação personalizada e os dados da conta |
| Status do pagamento | Gateway de pagamento | "Pagamento recebido. Obrigado" |
| Agendamento | Seu calendário ou sistema de agendamentos | Horários disponíveis e, depois, uma confirmação |
| Captação de leads | CRM ou Google Sheets | Um novo lead criado a partir da conversa |
| Respostas de IA | Seu mecanismo de IA ou serviço RAG | Uma resposta fundamentada para uma pergunta aberta |
| KYC ou verificação de elegibilidade | Serviço interno ou de terceiros | "Você é elegível. Veja a próxima etapa" |
Exemplos por setor
- D2C e e-commerce: rastreamento de pedidos, devoluções, consulta de estoque
- Educação: situação das mensalidades, horários das turmas, consulta de resultados
- Imóveis: consulte a disponibilidade de empreendimentos e unidades no seu CRM
- Saúde e clínicas: consulte horários disponíveis e confirme agendamentos
- Logística: rastreamento de remessas pelo número AWB
- Finanças e seguros: situação da apólice, datas de vencimento do prêmio
Conectando ao seu próprio mecanismo de IA
Se você criou sua própria camada de IA (um pipeline RAG, um modelo ajustado ou um copiloto de suporte), o nó de API faz a conexão.
O fluxo:
- Faça uma pergunta ao cliente com um nó de Pergunta
- Envie o texto para seu endpoint de IA pelo nó de API
- Armazene a resposta em uma variável
- Exiba-a em um nó de Mensagem
- Se a chamada falhar, encaminhe para uma pessoa
Algumas dicas:
- Retorne um campo de resposta curto e claro. Respostas longas são difíceis de ler no WhatsApp.
- Mantenha o tempo de resposta baixo. O cliente está acompanhando uma janela de conversa.
- Sempre tenha um caminho alternativo, porque os endpoints de IA podem exceder o tempo limite ou apresentar erros.
O Chakra também tem um Nó de IA integrado e recursos de IA conversacional. Use-os quando quiser usar IA sem escrever código. Use o nó de API quando quiser trazer seu próprio mecanismo, dados ou lógica de negócios.
Configurando no Chakra Chat
Veja o fluxo do guia do nó Call APIdo Chakra, explicado em etapas simples.
1. Configure a chamada de API
- Arraste o nó Call API para a tela, à direita do nó que coleta os dados de entrada
- Clique em Mostrar editor para abrir a configuração da API
- Insira sua URL e escolha o método HTTP
- Escolha um tipo de corpo: form url encoded ou form multipart
- Adicione seus pares chave/valor, por exemplo,
order_idassociado à resposta do cliente - Clique em Salvar API
2. Inclua os dados da conversa na solicitação
Digite {{ no payload para ver as variáveis que você pode inserir. Você pode usar o texto da última mensagem da conversa e tudo o que foi coletado anteriormente pelo chatbot.
É assim que o ID do pedido ou o e-mail do cliente vai parar na sua solicitação.
3. Armazene a resposta da API como uma variável
Em Armazenar resposta em variável?, insira um nome, como api_response.
4. Selecione o valor exato com um caminho JSON
Em Caminho JSON do valor a armazenar?, insira o caminho para o valor que você quer. A resposta é lida pela chave response.data.
Exemplo de resposta do seu servidor:
{
"order": {
"id": "4821",
"status": "Out for delivery",
"eta": "Today, 6 PM"
}
}
Para armazenar somente a situação, use:
response.data.order.status
Use o caminho para extrair apenas o valor de que você precisa e manter suas mensagens claras, sem exibir a resposta inteira.
5. Crie ramificações para sucesso e falha
O nó tem duas saídas:
- Sucesso: uma resposta 2xx
- Falha: uma resposta diferente de 2xx
Conecte cada saída ao próximo nó que você quiser.
6. Use a variável na sua resposta
Adicione um nó de Mensagem após a saída de sucesso. Digite @ e selecione sua variável. Por exemplo:
Boas notícias! A situação do seu pedido é: @order_status.
Salve o nó e, em seguida, salve o chatbot.
Um exemplo simples de endpoint
Do seu lado, basta retornar JSON. Veja um exemplo mínimo em Node.js (o seu será diferente):
app.use(express.urlencoded({ extended: true }));
app.post("/order-status", async (req, res) => {
const order = await db.findOrder(req.body.order_id);
if (!order) {
return res.status(404).json({ error: "Order not found" });
}
res.json({
order: { id: order.id, status: order.status, eta: order.eta }
});
});
Um 404 segue pela ramificação de falha , para que seu bot possa dizer "Não consegui encontrar esse pedido" em vez de não mostrar nada.
Testes antes de entrar no ar
Teste em etapas.
- Teste seu endpoint separadamente. Use primeiro uma ferramenta como cURL ou Postman. Confirme se ele retorna os códigos de status e o JSON esperados.
- Teste o fluxo no modo de pré-visualização do construtor. O construtor de chatbots do Chakra permite simular uma conversa no WhatsApp antes de entrar no ar.
- Teste os cenários de erro. ID de pedido incorreto, resposta vazia, servidor fora do ar.
- Confira o caminho JSON. Se a mensagem aparecer em branco, geralmente o caminho não corresponde à resposta.
- Teste em um celular de verdade com um número de teste antes de ativar para os clientes.
O que acontece depois da resposta?
Pense na resposta como uma bifurcação no caminho.
Em caso de sucesso (2xx):
- Mostre a resposta em um nó de mensagem
- Use o valor armazenado mais adiante no fluxo
- Avance para a próxima pergunta ou encerre a conversa com educação
Em caso de falha (não 2xx):
- Envie uma mensagem alternativa simpática
- Ofereça a opção de tentar novamente
- Encaminhe a conversa para uma pessoa usando o nó Atribuir a uma pessoa
Como lidar bem com falhas
Sua API vai falhar às vezes. Esteja preparado.
- Nunca deixe o cliente sem resposta. Todo nó de API deve ter um caminho para lidar com falhas.
- Use mensagens específicas. "Não encontramos esse pedido. Confira o ID" é melhor do que "Algo deu errado."
- Ofereça atendimento humano. É justamente nas falhas que uma pessoa pode agregar valor.
- Retorne códigos de status significativos. Um 404 para "não encontrado" e um 500 para "problema no servidor" permitem tratar cada caso de propósito.
- Faça a chamada rapidamente. A conversa espera pela resposta, então endpoints lentos parecem respostas demoradas.
- Não use isso para tarefas demoradas. Para qualquer tarefa que leve minutos, inicie o processo e envie o resultado depois, em uma mensagem separada.
Principais vantagens
- Respostas em tempo real, em vez de respostas prontas. Os clientes recebem dados reais na conversa.
- Menos chamados para sua equipe. Perguntas repetitivas são resolvidas do início ao fim.
- Funciona com os sistemas que você já usa. Não é necessário transferir seus dados para o chatbot.
- Use sua própria lógica. Regras de negócio, preços, critérios de elegibilidade e IA continuam no seu código.
- Fluxo low-code, código só onde for necessário. As equipes de operações gerenciam a conversa. Os desenvolvedores cuidam do endpoint.
- Reutilizável. Um endpoint pode atender a vários fluxos.
Por que não criar tudo no seu próprio sistema?
Você pode. Algumas equipes fazem isso. Veja o que está envolvido:
| Tarefa | Desenvolver por conta própria | Usar o Chakra com o nó de API |
|---|---|---|
| Conectar à WhatsApp Business Platform | Você desenvolve e mantém | Pronto para você |
| Receber e direcionar webhooks | Você desenvolve | Gerenciado na plataforma |
| Estado da conversa e lógica do fluxo | Você programa e armazena | Criador visual de fluxos |
| Gerenciamento de modelos | Você desenvolve | Gerenciamento nativo de modelos |
| Caixa de entrada da equipe e transferência para atendimento humano | Você desenvolve | Integrado |
| Lógica de negócio e dados | Seu código | Seu código, chamado pelo nó de API |
| Alterar um fluxo | Alterar o código e fazer o deploy | Editar no criador |
A escolha de verdade não é "desenvolver ou comprar". É no que você quer que seus desenvolvedores invistam tempo.
- Invista esse tempo na sua lógica de negócio: consultas de pedidos, preços, critérios de elegibilidade, IA
- Não em infraestrutura: conexões com o WhatsApp, webhooks, caixa de entrada e ferramentas de fluxo
Quando faz sentido desenvolver sua própria solução? Se a lógica do seu bot for extremamente personalizada ou se você precisar executar tudo na sua própria infraestrutura. Para a maioria das equipes, uma abordagem híbrida é mais rápida: a plataforma gerencia a conversa e seu sistema fornece as respostas.
Boas práticas
- Proteja seu endpoint. Use HTTPS e um método de autenticação. Nunca deixe um endpoint de dados aberto.
- Retorne um JSON pequeno e simples. É mais fácil de mapear e menos propenso a apresentar problemas.
- Mantenha os nomes dos campos estáveis. Alterar o formato da resposta pode fazer com que seu caminho JSON pare de funcionar sem aviso.
- Use nomes de variáveis claros como
order_status, em vez dedata1. - Valide a entrada primeiro. Confira o formato do ID do pedido no fluxo antes de chamar seu servidor.
- Sempre crie um caminho para falhas.
- Respeite a privacidade. Retorne apenas o que o cliente deve ver e verifique a identidade antes de exibir dados da conta.
- Registre as solicitações do seu lado para poder investigar problemas.
Limitações que você precisa conhecer
- O chat aguarda a resposta, então endpoints lentos prejudicam a experiência.
- Você precisa de um desenvolvedor para criar e proteger o endpoint.
- Erros no caminho JSON aparecerão como valores em branco.
- Confira qual plano inclui o nó Chatbot API na página de preços. O acesso à Developer API e a webhooks está incluído nos planos pagos a partir do Starter.
Por que as equipes usam isso no Chakra Chat
O Chakra atende mais de 2.500 clientes em mais de 65 países, e o criador de chatbots foi desenvolvido para ser simples para equipes de negócios e flexível para desenvolvedores.
- Criador visual com modo de pré-visualização para testar fluxos antes de publicá-los
- Suporte à coexistência para você manter o número do seu app WhatsApp Business. Veja como funciona
- Sem acréscimo sobre mensagens de modelo
- Ajuda na configuração e suporte contínuo
- Aplicativos para dispositivos móveis para iOS e Android
- APIs para desenvolvedores em apidocs.chakrahq.com para integrações mais avançadas
Quer conhecer o criador? Explore o criador de chatbots para WhatsApp.
Perguntas frequentes
O que é um nó de API em um chatbot do WhatsApp? É uma etapa do seu fluxo que envia uma solicitação a um sistema externo e usa a resposta na conversa.
O nó de API pode chamar meu próprio mecanismo de IA? Sim. Envie a mensagem do cliente ao seu endpoint de IA, armazene a resposta em uma variável e exiba-a em um nó de mensagem.
O que determina o sucesso ou a falha? O código de status HTTP. Uma resposta 2xx segue pelo caminho de sucesso. Qualquer outra resposta segue pelo caminho de falha.
Como seleciono um valor em uma resposta longa? Use o campo de caminho JSON. A resposta é lida por meio de response.data, então um campo de status poderia ser response.data.order.status.
Posso enviar os dados do cliente para minha API? Sim. Digite {{ no payload para inserir a última mensagem do chat ou qualquer variável coletada anteriormente.
E se meu servidor estiver fora do ar? O fluxo seguirá pelo caminho de falha. Use-o para enviar uma resposta alternativa educada e transferir o atendimento para uma pessoa.
Preciso programar? Você não precisa programar o fluxo do chatbot. Mas precisa de um desenvolvedor para criar o endpoint chamado pelo nó.
De qual plano preciso? O acesso à Developer API e a webhooks está disponível nos planos pagos a partir do Starter. Confira a página de preços para ver qual plano inclui o nó Chatbot API.
Para concluir
Um chatbot que só envia mensagens predefinidas é um menu. Um chatbot que pode consultar seus sistemas para saber a resposta é um assistente.
O nó de API é a pequena etapa que faz a diferença: colete a informação, chame seu sistema, armazene a resposta e defina um caminho para o sucesso ou a falha. Comece com um caso de uso simples, como consultar o status de um pedido ou verificar um cupom, e avance a partir daí.
Referências
- Ajuda do Chakra: Use o nó Call API no chatbot
- Chakra Chat: Criador de chatbots para WhatsApp
- Chakra Chat: APIs para desenvolvedores
- Documentação da API do Chakra
- Preços do Chakra Chat