Automação

Automatizando WhatsApp Business com Python: chatbots e notificações em escala

Automatizando WhatsApp Business com Python: chatbots e notificações em escala

WhatsApp é o canal de comunicação mais usado no Brasil — 99% dos smartphones têm o app instalado. A API oficial do WhatsApp Business permite que empresas enviem notificações, respondam automaticamente e criem chatbots inteligentes a partir do seu próprio sistema. Não estamos falando de ferramentas de terceiros questionáveis — é a API oficial da Meta, com criptografia end-to-end e conformidade com políticas de privacidade.

WhatsApp Business API: setup e conceitos

A API do WhatsApp Business opera via Cloud API (hospedada pela Meta, mais simples) ou On-Premises API (hospedada por você, mais controle). Para a maioria das empresas, Cloud API é a escolha — acesso gratuito até 1000 conversas por mês, setup via Meta Business Suite, e webhook para receber mensagens em tempo real. Você precisa de: conta Meta Business, número de telefone dedicado (não pode ser o mesmo do WhatsApp pessoal), e verificação de negócio aprovada.

Dois conceitos fundamentais: message templates (modelos pré-aprovados pela Meta para iniciar conversas) e session messages (mensagens livres dentro de uma janela de 24h após resposta do usuário). Você não pode enviar mensagens promocionais não solicitadas — apenas templates aprovados para notificações como confirmação de pedido, atualização de entrega, ou lembretes de agendamento. Dentro da janela de 24h, o chatbot pode responder livremente.

Backend com Python e Flask

O webhook recebe eventos via POST request: mensagens de texto, imagens, áudio, localização, botões interativos clicados e status de entrega. Com Flask, configure um endpoint /webhook que verifica o token de segurança (GET para verificação, POST para mensagens). Parse o payload JSON para extrair: remetente (wa_id), tipo de mensagem, conteúdo, e timestamp. Armazene cada mensagem no banco para histórico e analytics.

Para enviar mensagens, use a Graph API da Meta: POST para https://graph.facebook.com/v18.0/{phone_id}/messages com o payload estruturado. Mensagens de texto, imagens, documentos, botões interativos e listas são suportados. Para templates, especifique o nome do template e os parâmetros dinâmicos (nome do cliente, número do pedido, etc). A biblioteca requests do Python torna cada chamada trivial — 5 linhas de código enviam uma mensagem com botões interativos.

Chatbot inteligente com IA

Combine a API do WhatsApp com LLMs para criar assistentes realmente inteligentes. O fluxo: recebe mensagem via webhook, envia ao LLM (OpenAI, Anthropic ou modelo local) com system prompt definindo personalidade e regras do bot, recebe resposta, e envia de volta pelo WhatsApp. Para atendimento ao cliente, inclua RAG com base de conhecimento da empresa: o bot busca informações relevantes em documentos internos antes de responder.

Estado da conversa é essencial para chatbots multi-turn. Armazene o histórico de mensagens de cada usuário (Redis para sessões curtas, banco SQL para histórico permanente) e envie as últimas N mensagens como contexto ao LLM. Implementar menus interativos com botões e listas do WhatsApp para navegação estruturada: “Escolha um departamento: 1) Vendas 2) Suporte 3) Financeiro”. Combine menu estruturado para ações comuns e linguagem natural para perguntas complexas.

Notificações automatizadas

Templates aprovados permitem notificações proativas em escala. Casos de uso comprovados: confirmação de pedido com tracking link, lembrete de consulta/agendamento 24h antes, atualização de status de entrega em tempo real, boleto próximo do vencimento, e follow-up pós-venda com pesquisa de satisfação. Cada template tem taxa de entrega superior a 90% — muito acima de email (20-30% de abertura).

Para agendamento, use Celery com Redis como broker: tarefas agendadas disparam envio de templates no horário configurado. O padrão de retry com backoff exponencial lida com falhas temporárias da API. Para volume alto (10.000+ mensagens/dia), implemente rate limiting para respeitar os limites da API e batching para otimizar throughput. Métricas essenciais: delivery rate, read rate, response rate, e opt-out rate — monitore continuamente para ajustar frequência e conteúdo.

Tem um projeto em mente?

Somos especialistas em transformar ideias em produtos digitais. Apps, sites, automações e IA — vamos construir juntos.

Resposta rápida Orçamento sem compromisso +100 projetos entregues
Compartilhar: