Integracao com WhatsApp Business Cloud API (Meta). Mensagens, templates, webhooks HMAC-SHA256, automacao de atendimento. Boilerplates Node.js e Python.
Standardmäßig ist der Prompt ausgewählt, der zuerst die Quelle prüft. Sie können zu einem direkten Befehl wechseln oder eine lokale Kopie herunterladen.
Quelldateien prüfen
Lesen Sie SKILL.md und alle von SkillsMP angezeigten Begleitdateien, bevor Sie sich für eine Installation entscheiden.
Mit Codex oder Claude installieren Kopieren Sie diesen Prompt, fügen Sie ihn in Codex, Claude oder einen anderen Assistant ein und lassen Sie die Skill-Seite prüfen und installieren.
Ein direkter Befehl überspringt den Prüf-Prompt. Prüfen Sie die Quelle, bevor Sie ihn ausführen.
Integracao com WhatsApp Business Cloud API (Meta). Mensagens, templates, webhooks HMAC-SHA256, automacao de atendimento. Boilerplates Node.js e Python.
Integracao com WhatsApp Business Cloud API (Meta). Mensagens, templates, webhooks HMAC-SHA256, automacao de atendimento. Boilerplates Node.js e Python.
When to Use This Skill
When the user mentions "whatsapp" or related topics
When the user mentions "whatsapp business" or related topics
When the user mentions "api whatsapp" or related topics
When the user mentions "chatbot whatsapp" or related topics
When the user mentions "mensagem whatsapp" or related topics
When the user mentions "template whatsapp" or related topics
Do Not Use This Skill When
The task is unrelated to whatsapp cloud api
A simpler, more specific tool can handle the request
The user needs general-purpose assistance without domain expertise
How It Works
Skill para implementar integracoes profissionais com WhatsApp Business usando a Cloud API oficial da Meta. Suporta Node.js/TypeScript e Python.
Overview
A WhatsApp Cloud API e a API oficial da Meta para envio e recebimento de mensagens via WhatsApp Business. Desde outubro 2025, e a unica opcao suportada (a API On-Premises foi descontinuada).
Versao da API: Graph API v21.0 (2026)
Base URL:https://graph.facebook.com/v21.0/{phone-number-id}/messagesAutenticacao: Bearer Token (System User Token para producao)
Pricing 2026 (por mensagem):
Categoria
Custo
Quando cobrado
Marketing
$0.025-$0.1365
Campanhas, promocoes
Utility
$0.004-$0.0456
Confirmacoes de pedido, atualizacoes
Authentication
$0.004-$0.0456
OTP, reset de senha
Service
GRATIS
Resposta dentro da janela de 24h
Pre-requisitos:
Conta Meta Business Suite (gratuita)
App no Meta for Developers com produto WhatsApp
Numero de telefone verificado
System User Token (permanente)
Se o usuario nao tem conta Meta Business, leia references/setup-guide.md para o guia completo de setup do zero.
Importante: Usar crypto.timingSafeEqual (Node.js) ou hmac.compare_digest (Python) para prevenir timing attacks. Nunca use comparacao simples de strings.
Eventos Recebidos
messages - Mensagem do cliente (texto, midia, botao, localizacao)
statuses - Atualizado de status (sent → delivered → read)
errors - Erros de entrega
Requisitos:
Endpoint HTTPS com certificado SSL valido
Responder com HTTP 200 em ate 5 segundos
Dev: use ngrok para teste local
Para setup completo com exemplos Node.js e Python, leia references/webhook-setup.md.
Menu Principal Interativo
Use botoes ou listas para criar um menu de opcoes na primeira interacao:
## Python - Menu Com Lista Interativaasyncdefsend_main_menu(to: str):
await send_interactive_list(
to=to,
header="Bem-vindo!",
body="Selecione o que precisa:",
button_text="Ver opcoes",
sections=[{
"title": "Atendimento",
"rows": [
{"id": "suporte", "title": "Suporte Tecnico", "description": "Ajuda com problemas"},
{"id": "vendas", "title": "Vendas", "description": "Conhecer nossos produtos"},
{"id": "financeiro", "title": "Financeiro", "description": "Boletos e pagamentos"},
]
}]
)
State Machine Para Fluxos
Gerencie conversas com uma maquina de estados. Cada cliente tem um estado atual que determina como a proxima mensagem sera processada:
Dentro da janela (24h apos ultima mensagem do cliente): Pode enviar qualquer tipo de mensagem gratuitamente
Fora da janela: Apenas template messages (cobradas por categoria)
Integracao Com Ia (Claude Api)
Combine WhatsApp com Claude para respostas inteligentes:
Receba mensagem via webhook
Envie para Claude API com contexto da conversa
Retorne resposta via WhatsApp
Mantenha escalacao para humano disponivel
Para padroes completos de automacao, leia references/automation-patterns.md.
Whatsapp Flows
Formularios interativos multi-tela dentro do WhatsApp. O cliente preenche campos sem sair do app. Definidos em JSON com screens, components e actions.
Use cases: cadastros, agendamentos, pesquisas NPS, selecao de produtos.
Commerce & Catalogo
Ate 500 produtos no catalogo WhatsApp. Envie mensagens de produto individual ou multi-produto com checkout in-app.
Template Management Api
Crie, liste e delete templates programaticamente. Ate 6000 traducoes por conta. Aprovacao em minutos.
Whatsapp Channels
Broadcasting unidirecional para subscribers ilimitados. Localizado na aba "Atualizacoes" do WhatsApp.
Click-To-Whatsapp Ads
Anuncios no Facebook/Instagram com botao que abre conversa no WhatsApp. 99% de taxa de abertura.
Status Tracking
Rastreie entrega: pending → server → device → read. Receba via webhook de status updates.
Para detalhes completos de features avancados, leia references/advanced-features.md.
Para gerenciamento de templates via API, leia references/template-management.md.
Checklist Essencial
Opt-in explicito obtido antes de enviar mensagens
Mecanismo de opt-out implementado (keyword "SAIR" ou "STOP")
Registro de consentimento com timestamp, metodo e proposito
Conteudo dentro das politicas do WhatsApp (sem spam, sem conteudo proibido)
LGPD/GDPR compliance (base legal definida, direitos do titular)
Frequencia de mensagens adequada (nao excessiva)
Templates aprovados antes do uso
Verificacao de negocio completa (para limites maiores)
Quality Rating
O WhatsApp monitora a qualidade das suas mensagens e atribui um rating:
Rating
Significado
Acao
Verde
Boa qualidade, poucos bloqueios
Manter — elegivel para upgrade
Amarelo
Qualidade media, atencao necessaria
Revisar conteudo e frequencia
Vermelho
Qualidade baixa, risco de suspensao
Acao imediata: reduzir volume
Sinais positivos: Alta taxa de resposta, engajamento, poucos bloqueios
Sinais negativos: Bloqueios, reports de spam, baixo engajamento
Tier System (Limites De Mensagem)
Desde outubro 2025, limites sao por Business Portfolio (nao por numero):
Tier
Conversas/24h
Como alcancar
Inicial
250
Conta nova / nao verificada
Tier 1
1,000
Auto-upgrade: 50%+ do limite por 7 dias
Tier 2
10,000
Auto-upgrade: 50%+ do limite por 7 dias
Tier 3
100,000
Auto-upgrade: 50%+ do limite por 7 dias
Unlimited
Ilimitado
Auto-upgrade: 50%+ do limite por 7 dias
Mudancas 2026: Tiers 2K e 10K serao removidos. Apos verificacao de negocio, limite imediato de 100K.
Para guia completo de compliance, leia references/compliance.md.
Troubleshooting
Problema
Causa Provavel
Solucao
401 Unauthorized
Token expirado ou invalido
Gerar novo System User Token
400 Bad Request
Payload malformado
Verificar JSON contra exemplos
Template rejeitado
Conteudo viola politicas
Revisar e resubmeter com alteracoes
Webhook nao recebe
URL invalida ou sem HTTPS
Usar ngrok (dev) ou certificado SSL (prod)
Rate limit exceeded
Ultrapassou 80 msg/s
Implementar queue com retry
Quality rating baixo
Muitos bloqueios/reports
Reduzir volume, melhorar conteudo
Mensagem nao entregue
Numero invalido ou nao no WhatsApp
Validar numero antes de enviar
Numero nao verificado
OTP nao completado
Repetir verificacao via SMS ou ligacao
Para validar sua configuracao:
python scripts/validate_config.py
Referencias (Leia Conforme Necessidade)
Arquivo
Quando ler
references/setup-guide.md
Setup inicial — criar conta Meta, configurar API
references/message-types.md
Exemplos completos de todos os tipos de mensagem
references/webhook-setup.md
Configurar webhooks com seguranca HMAC
references/automation-patterns.md
Chatbot, filas, state machine, integracao IA
references/compliance.md
LGPD/GDPR, opt-in, quality rating, tier system
references/api-reference.md
Endpoints, erros, rate limits, pricing 2026
references/advanced-features.md
Flows, Commerce, Channels, Ads, Status Tracking
references/template-management.md
CRUD de templates via API
Scripts
Script
O que faz
scripts/setup_project.py
Cria projeto com boilerplate (Node.js ou Python)
scripts/validate_config.py
Valida credenciais e conexao com a API
scripts/send_test_message.py
Envia mensagem teste para validar setup
Boilerplate
Diretorio
Conteudo
assets/boilerplate/nodejs/
Projeto TypeScript/Express completo
assets/boilerplate/python/
Projeto Python/Flask completo
assets/examples/
Exemplos de payloads JSON (templates, webhooks, flows)
Best Practices
Provide clear, specific context about your project and requirements
Review all suggestions before applying them to production code
Combine with other complementary skills for comprehensive analysis
Common Pitfalls
Using this skill for tasks outside its domain expertise
Applying recommendations without understanding your specific context
Not providing enough project context for accurate analysis
Related Skills
instagram - Complementary skill for enhanced analysis
social-orchestrator - Complementary skill for enhanced analysis
telegram - Complementary skill for enhanced analysis
