Evolution API: WhatsApp como canal

O cliente está no WhatsApp — e a Evolution API é como a plataforma conversa com as redes de postos por lá, com IA nos bastidores.

O que é

API (open-source) que conecta o WhatsApp à plataforma, permitindo tratar mensagem como dado: enviar, capturar, resumir e registrar. Funciona criando instâncias que representam números conectados.

Onde usamos

• Envio por instância do usuário — cada pessoa manda pela própria instância (users.whatsapp_instance_name), não por um número genérico. O cliente fala com quem conhece.
• Resumos de conversa por IA — briefing diário do que rolou em cada rede.

Conceitos-chave

• Instância — uma sessão de WhatsApp conectada (via QR code). Ciclo de vida: criar → conectar → usar → reconectar quando cair.
• Webhooks — a Evolution avisa a plataforma de mensagens recebidas/eventos.
• Tipos de mensagem — texto, mídia, template, botões.

Boas práticas (anti-ban e relacionamento)

• Personalize de verdade — nome, contexto, histórico. Mensagem robô afasta o cliente e atrai bloqueio.
• Respeite ritmo e horário — volume alto e disparo madrugada queimam o número.
• Aqueça números novos — comece devagar, suba o volume com o tempo.
• Tenha trilha — quem mandou, quando, por qual instância (o modelo por usuário dá isso de graça).
• IA assiste, humano decide em mensagem sensível.

Como começar

• EVOLUTION_API_URL, EVOLUTION_API_KEY, EVOLUTION_INSTANCE_NAME, EVOLUTION_WEBHOOK_SECRET.
• Instâncias geridas de forma central; instância faltando = ação bloqueada (melhor falhar alto que mandar pelo número errado).

Pegadinhas

• ⚠️ WhatsApp pune automação mal feita — disparo em massa genérico = número banido + relação queimada.
• ⚠️ Instância cai (desconecta) — tenha reconexão e alerta, senão a automação para em silêncio.
• ⚠️ Não é API oficial da Meta — entenda o trade-off de usar uma camada sobre o WhatsApp.
• ⚠️ Consentimento — automação não dispensa bom senso e opt-out.

Quando usar (e quando não)

Use pra relacionamento e atendimento no canal onde o cliente responde rápido. Não use pra spam nem pra delegar à IA o envio de mensagem delicada.

Automação boa no WhatsApp é a que o cliente nem percebe — ele só sente que foi bem atendido, rápido.

Próximo da série: #06 — GitHub.