Back-End

WhatsApp Business API para corte feminino na Liberdade automatizado

Automatize agendamentos de corte feminino na Liberdade com WhatsApp Business API. Integração técnica, fluxos de conversa e escalabilidade para salões.

O WhatsApp Business API processa mais de 100 bilhões de mensagens por dia globalmente, e salões que automatizam agendamentos via API reduzem no-shows em até 35% segundo benchmarks de mercado. Para um corte feminino na Liberdade — região de alta densidade e fluxo intenso —, a diferença entre responder manualmente e operar com fluxos programáticos define margem de lucro e reputação.

A API não é apenas um canal de chat; é uma interface programável que expõe webhooks, templates aprovados (HSM), gerenciamento de sessão de 24 horas e cobrança por conversa. Dominar essa stack exige conhecimento de back-end, filas assíncronas, idempotência e conformidade com políticas da Meta e LGPD — exatamente o que este artigo cobre na prática.

Escolhendo o BSP e provisionando a infraestrutura

O primeiro passo técnico é selecionar um Business Solution Provider (BSP) homologado. No Brasil, Twilio, Zenvia, Take Blip e Wati são os mais adotados. Cada um expõe SDKs, painel de templates, analytics e suporte a webhooks. A decisão passa por: latência de entrega no Brasil, custo por conversa além da taxa Meta, suporte a multi-atendente nativo e facilidade de deploy do seu código.

Provisione um número exclusivo para o salão — não pode ser o mesmo do WhatsApp pessoal ou do Business App. No console do BSP, vincule o número ao seu Meta Business Manager, complete a verificação de dois fatores e gere o token de acesso permanente (PAT) com escopo whatsapp_business_messaging e whatsapp_business_management. Armazene esse token em cofre de segredos (AWS Secrets Manager, HashiCorp Vault, ou .env criptografado em CI/CD).

Webhooks, validação e processamento assíncrono

A Meta exige endpoint HTTPS com certificado TLS válido, respondendo 200 OK em até 20 segundos. Configure a URL do webhook no painel do BSP e assine os campos messages, message_template_status_update e message_deliveries. O payload chega como JSON; valide a assinatura X-Hub-Signature-256 usando o app_secret para evitar spoofing.

import hmac, hashlib, json
from fastapi import FastAPI, Request, Header, HTTPException
from pydantic import BaseModel
import redis

app = FastAPI()
redis_client = redis.Redis(decode_responses=True)
APP_SECRET = "seu_app_secret"

class WhatsAppPayload(BaseModel):
    object: str
    entry: list

@app.post("/webhook/whatsapp")
async def whatsapp_webhook(
    payload: WhatsAppPayload,
    x_hub_signature_256: str = Header(None)
):
    body = json.dumps(payload.dict(), separators=(',', ':')).encode()
    expected = "sha256=" + hmac.new(APP_SECRET.encode(), body, hashlib.sha256).hexdigest()
    if not hmac.compare_digest(expected, x_hub_signature_256):
        raise HTTPException(401, "Assinatura inválida")
    
    for entry in payload.entry:
        for change in entry.get("changes", []):
            value = change.get("value", {})
            for msg in value.get("messages", []):
                msg_id = msg["id"]
                if redis_client.setnx(f"msg:{msg_id}", "1"):
                    redis_client.expire(f"msg:{msg_id}", 86400)
                    redis_client.lpush("queue:whatsapp_in", json.dumps(msg))
    return {"status": "ok"}

Processamento pesado (consulta agenda, regras de negócio, envio de template) deve ocorrer em worker separado (Celery, RQ, BullMQ) para não travar o webhook. Implemente retentativa exponencial com dead-letter queue para falhas persistentes.

Templates HSM: estratégia de aprovação e variáveis

Templates de mensagem (Highly Structured Messages) são a única forma de iniciar conversa fora da janela de 24h ou enviar notificações proativas. Para corte feminino na Liberdade, o conjunto mínimo inclui:

Categoria Nome do Template Exemplo de Corpo
UTILITY agendamento_confirmado “Olá {{1}}, seu corte com {{2}} está confirmado para {{3}} às {{4}}. Endereço: Rua Galvão Bueno, 123. Responda REAGENDAR ou CANCELAR.”
UTILITY lembrete_24h “Lembrete: seu corte com {{1}} é amanhã às {{2}}. Chegue 10 min antes. Qualquer mudança, responda aqui.”
MARKETING pos_atendimento “Obrigada por escolher nosso salão, {{1}}! Como foi seu corte com {{2}}? Avalie: [link]”
UTILITY reagendamento_opcoes “Para reagendar, escolha: 1) {{1}} às {{2}} 2) {{3}} às {{4}} 3) Outro horário. Responda com o número.”

Submeta via API do BSP ou painel. A Meta rejeita templates com: linguagem promocional excessiva, variáveis em sequência sem texto, URLs não verificadas, ou corpo idêntico a outro template. Mantenha versão semântica (v1, v2) para rastrear aprovações.

Máquina de estados do fluxo de agendamento

Modelar a conversa como máquina de estados finitos evita loops e estados inconsistentes. Estados sugeridos:

  1. INICIO → recebe oi, agendar, corte → envia template servicos_disponiveis (lista: corte feminino, corte + hidratação, franja)
  2. ESCOLHA_SERVICO → valida opção → ESCOLHA_PROFISSIONAL
  3. ESCOLHA_PROFISSIONAL → mostra profissionais disponíveis (consulta agenda em tempo real) → ESCOLHA_DATA_HORA
  4. ESCOLHA_DATA_HORA → apresenta 3 slots próximos → CONFIRMACAO
  5. CONFIRMACAO → envia template agendamento_confirmado → AGENDADO
  6. AGENDADO → aceita REAGENDAR, CANCELAR, DUVIDA → transições apropriadas

Persista o estado por wa_id (WhatsApp ID do contato) em Redis com TTL de 48h. Em cada mensagem inbound, recupere estado, valide transição, execute ação (reserva slot, cancela, envia template) e atualize estado. Use distributed lock (Redis SETNX) ao reservar slot para evitar race condition entre duas clientes pedindo o mesmo horário.

Integração com agenda em tempo real

A disponibilidade real evita overbooking. Duas abordagens principais:

Google Calendar API: crie service account com domínio delegado, compartilhe calendários dos profissionais, use events.list com timeMin/timeMax e singleEvents=true. Slots livres = janelas de trabalho menos eventos existentes. Requer refresh token rotacionado e tratamento de quota (500 req/s por projeto).

Banco próprio (PostgreSQL + advisory locks): tabela slots (profissional_id, inicio, fim, status) com índice parcial WHERE status = 'LIVRE'. Reserva atômica:

UPDATE slots
SET status = 'RESERVADO', cliente_wa_id = $1, updated_at = now()
WHERE id = (
  SELECT id FROM slots
  WHERE profissional_id = $2 AND inicio >= $3 AND status = 'LIVRE'
  ORDER BY inicio LIMIT 1
  FOR UPDATE SKIP LOCKED
)
RETURNING *;

Essa query garante atomicidade sem lock de tabela inteira. Combine com idempotency key (wa_id + slot_id) para reprocessamento seguro.

Monitoramento, métricas e conformidade LGPD

Implemente dashboard (Grafana + Prometheus ou Datadog) com métricas-chave:

  • whatsapp_webhook_latency_p95 < 500ms
  • template_rejection_rate < 2%
  • conversation_start_rate (business-initiated vs user-initiated)
  • opt_out_diario (usuários que enviam STOP)
  • no_show_rate (agendados vs comparecidos via check-in manual)

Alertas: falha de webhook > 1% em 5 min, template rejeitado, fila de worker > 1000 mensagens.

Para LGPD: registre consent_timestamp e consent_source (ex: template_opt_in_v3) no primeiro INICIO. Ofereça comando EXCLUIR MEUS DADOS que dispara job de anonimização (substitui nome por CLIENTE_<hash>, remove telefone do CRM, mantém apenas agregados estatísticos). Documente Data Processing Addendum com o BSP.

Escalando: multi-atendente, filas e roteamento inteligente

Quando o volume supera 50 conversas simultâneas, um único bot não basta. Implemente roteamento:

  • Prioridade: clientes VIP (tag no CRM) → fila dedicada
  • Habilidade: profissionais especialistas em corte curto, longo, químicas → skill-based routing
  • Horário: fora do expediente → bot de FAQ + agendamento para próximo dia útil

Use conversation handoff: bot qualifica (serviço, profissional, horário) e transfere para atendente humano via conversation_control (pausa bot, notifica atendente via Slack/Teams). Ao final, atendente devolve controle ao bot para pós-venda.

A arquitetura recomendada segue princípios de arquitetura serverless e sua aplicabilidade no back-end moderno — funções stateless, filas gerenciadas, secrets rotacionados, observabilidade nativa. Para deploy, pipelines de automatizando deployments com ferramentas de DevOps escaláveis garantem zero-downtime e rollback automático em falha de health check.

Se o salão já possui sistema de gestão próprio, a integração bidirecional (webhook de agendamento criado no ERP → envia template confirmação; cancelamento no ERP → envia template cancelamento) elimina digitação duplicada. Veja padrões em como criar sistema de gestão para oficina mecânica completa — a lógica de sincronização de estado é análoga.

Para atrair clientes que buscam especificamente corte de cabelo feminino em Liberdade, a automação via WhatsApp Business API torna-se diferencial competitivo: resposta imediata, confirmação por escrito, lembrete automático e reposição de slot cancelado em segundos.

Automatizar agendamentos com WhatsApp Business API exige engenharia de back-end sólida: webhooks assíncronos, máquina de estados, idempotência, templates aprovados e observabilidade. Implemente em camadas, teste exaustivamente em staging com números de homologação e meça no-show e tempo de primeira resposta. O resultado é uma operação que escala sem perder o toque humano que define um bom salão na Liberdade.

Checklist prático

0 de 9 concluídos

Perguntas frequentes

Qual a diferença entre WhatsApp Business App e WhatsApp Business API para um salão na Liberdade?

O WhatsApp Business App é limitado a um dispositivo e não escala para múltiplos atendentes simultâneos. A API permite integração com sistemas de agendamento, chatbots, múltiplos operadores e automações programáticas essenciais para fluxo contínuo de clientes.

Preciso de número verificado (green badge) para usar a API no meu salão?

Não é obrigatório para começar. O green badge exige processo de verificação de negócio junto à Meta e volume consistente de mensagens. Para iniciar, use número verificado via BSP (Business Solution Provider) e solicite o badge conforme cresce a operação.

Como lidar com templates de mensagem (HSM) para agendamento de corte feminino?

Templates devem ser pré-aprovados pela Meta. Crie modelos para confirmação, lembrete 24h antes, reagendamento e cancelamento. Use variáveis dinâmicas (nome, data, horário, profissional) e mantenha linguagem neutra para evitar rejeição na revisão.

É possível integrar a API com Google Calendar ou Calendly para evitar conflitos de horário?

Sim. A integração ocorre via webhook: ao receber intenção de agendamento, seu back-end consulta disponibilidade em tempo real no Google Calendar via API, reserva o slot e responde ao cliente com confirmação imediata, tudo dentro da conversa no WhatsApp.

Quais custos envolvidos além da hospedagem do servidor?

Há custo por conversa iniciada (user-initiated ou business-initiated) definido pela Meta por região. No Brasil, conversas de serviço (iniciadas pelo usuário) têm janela de 24h gratuita após primeira mensagem; templates fora da janela são cobrados. BSPs podem adicionar taxa de plataforma.

Como garantir LGPD no atendimento automatizado via WhatsApp?

Obtenha consentimento explícito no primeiro contato (opt-in), armazene apenas dados necessários (nome, telefone, histórico de serviços), criptografe em repouso e trânsito, implemente política de retenção e exclusão sob solicitação, e registre logs de consentimento para auditoria.