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:
INICIO→ recebeoi,agendar,corte→ envia templateservicos_disponiveis(lista: corte feminino, corte + hidratação, franja)ESCOLHA_SERVICO→ valida opção →ESCOLHA_PROFISSIONALESCOLHA_PROFISSIONAL→ mostra profissionais disponíveis (consulta agenda em tempo real) →ESCOLHA_DATA_HORAESCOLHA_DATA_HORA→ apresenta 3 slots próximos →CONFIRMACAOCONFIRMACAO→ envia templateagendamento_confirmado→AGENDADOAGENDADO→ aceitaREAGENDAR,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< 500mstemplate_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
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.