Como Integrar o ChatGPT ao WhatsApp Business via API em 2026

Integrar o ChatGPT ao WhatsApp Business permite criar um assistente de atendimento que entende linguagem natural, mantém contexto de conversa e responde em português fluente. A integração exige a API Oficial do WhatsApp Business e a API da OpenAI funcionando juntas.

O que é necessário antes de começar

A integração entre ChatGPT e WhatsApp Business requer quatro ingredientes: acesso à API Oficial do WhatsApp Business via Meta Business Manager, uma chave de API da OpenAI, um servidor para hospedar o webhook e uma lógica para orquestrar as chamadas entre os dois serviços.

• Conta no Meta Business Manager com número de telefone registrado na API
• Chave de API da OpenAI (platform.openai.com)
• Servidor Node.js, Python ou similar para o webhook
• Banco de dados ou cache para guardar o histórico de cada conversa

Arquitetura da integração: como funciona o fluxo

Quando um usuário envia uma mensagem ao seu número do WhatsApp Business, a Meta dispara um webhook POST para o endpoint que você configurou. Seu servidor recebe o payload, extrai o texto da mensagem e o número do remetente, busca o histórico da conversa no banco, monta o array de mensagens para a API da OpenAI e envia a requisição. A resposta do GPT é então enviada de volta ao usuário via API do WhatsApp.

O ponto crítico é o histórico: sem manter o contexto das mensagens anteriores, cada resposta do GPT será como se fosse o primeiro contato. Guarde as últimas 10 a 20 mensagens por sessão de conversa.

Exemplo de código: webhook básico em Node.js

O exemplo abaixo mostra a estrutura básica de um webhook que recebe mensagens do WhatsApp e responde com o ChatGPT. É um ponto de partida para customização.

• Instale as dependências: npm install express openai axios
• Configure as variáveis de ambiente: OPENAI_API_KEY, WHATSAPP_TOKEN, VERIFY_TOKEN
• Implemente o endpoint GET /webhook para verificação da Meta
• Implemente o endpoint POST /webhook para processar mensagens recebidas
• Extraia messages[0].text.body do payload da Meta para obter o texto
• Use openai.chat.completions.create() com o histórico montado
• Envie a resposta via POST para graph.facebook.com/v19.0/{phone_number_id}/messages

Como escrever o prompt de sistema para atendimento

O prompt de sistema é o que define o comportamento do GPT na conversa. Para atendimento ao cliente, ele deve incluir: quem é a empresa, o que ela vende, tom de voz, o que o bot pode e não pode fazer e quando transferir para um humano.

Um bom prompt de sistema para atendimento tem entre 200 e 500 palavras. Mais curto e o bot fica genérico demais. Mais longo e você começa a desperdiçar tokens em cada chamada.

Limitações e como contorná-las

A integração direta tem algumas limitações práticas que precisam ser consideradas antes de ir para produção.

• Latência: chamadas à OpenAI levam 1 a 5 segundos, o usuário pode achar que o bot travou. Envie um indicador de digitação enquanto processa.
• Custo por token: conversas longas ficam caras. Limite o histórico a 10 turnos.
• Alucinações: o GPT pode inventar informações. Use RAG com sua base de conhecimento para respostas sobre produtos, preços e políticas.
• Sem memória persistente entre sessões: implemente um banco de dados para guardar preferências do cliente.
• Rate limits da OpenAI: em alto volume, configure retry com backoff exponencial.

Alternativa sem código: plataformas que já fazem isso

Se o seu foco é o negócio e não a engenharia, plataformas como a Unnica já entregam essa integração pronta. Você configura o prompt do agente, conecta sua base de conhecimento e o sistema gerencia webhooks, histórico de conversa, handoff para humano e métricas, sem precisar escrever uma linha de código.

Perguntas frequentes