StackZap Cloud
A StackLab gerencia a infraestrutura do ambiente Cloud; os Termos descrevem API e banco PostgreSQL separados por cliente, sem afirmar servidor físico exclusivo. Consulte cotas e condições vigentes antes de contratar.
Guia de arquitetura · API de WhatsApp
API de WhatsApp não oficial: o que significa e como escolher
Uma API de WhatsApp não oficial conecta sistemas a uma conta do aplicativo por um método independente da plataforma empresarial da Meta. A StackZap usa o fluxo de dispositivos vinculados, como QR Code ou código de pareamento. Essa distinção muda requisitos, operação e riscos da sua integração.
O que é uma API de WhatsApp não oficial?
“API” descreve uma interface para sistemas trocarem dados; não informa, sozinha, quem fornece a conexão com o WhatsApp. No modelo independente, um software de terceiros conecta uma sessão do aplicativo — na StackZap, por pareamento — e expõe operações HTTP para enviar ou consultar dados. Já a WhatsApp Business Platform é a solução empresarial oficial da Meta, com seus próprios processos, recursos, contratos e políticas.
Por isso, compare o mecanismo de conexão, os termos, o suporte e as responsabilidades, não apenas uma lista de endpoints. Se um contrato, política interna ou requisito regulatório exige a plataforma oficial, confirme essa condição diretamente na documentação da Meta antes de escolher uma integração independente.
| Critério | StackZap independente | WhatsApp Business Platform |
|---|---|---|
| Como a conta conecta | Sessão pareada pelo aplicativo, por QR Code ou código de conexão. | Configuração pelos recursos empresariais e processos publicados pela Meta. |
| Quem define o contrato | Documentação, versão e Termos StackZap para a API independente. | Documentação, termos, políticas e condições comerciais da Meta e de eventuais provedores. |
| Operação | A equipe precisa acompanhar o estado da sessão e preparar tratamento para desconexões. | A equipe precisa operar os ativos, permissões, templates e regras do modelo oficial. |
| Quando avaliar | Quando a arquitetura aceita uma solução independente e a equipe compreende os requisitos e riscos. | Quando o projeto exige explicitamente recursos ou vínculo da plataforma oficial. |
Como a StackZap funciona
Na StackZap, o operador cria uma instância, conecta a conta pelo fluxo de dispositivos vinculados e chama a API do ambiente. Requisições protegidas usam o cabeçalho X-API-Key. Por exemplo, o endpoint de texto documentado é POST /v1/instances/{id}/messages/text; a URL base do StackZap Cloud é específica do ambiente e deve ser copiada do painel, não inferida de um exemplo.
curl -X POST "$STACKZAP_API_URL/v1/instances/$STACKZAP_INSTANCE_ID/messages/text" \
-H "X-API-Key: $STACKZAP_API_KEY" \
-H "Content-Type: application/json" \
-d '{"to":"DESTINATARIO_JID","text":"Mensagem de teste"}'O exemplo usa valores fictícios. Faça primeiro um teste pequeno com um destinatário autorizado, proteja a chave no servidor e valide o retorno da API. Para receber eventos, configure um webhook e verifique a assinatura conforme a versão documentada. Veja também os guias de conceitos de API, webhooks e API oficial ou independente.
StackZap self-hosted
Na instalação própria, sua equipe opera servidor, banco, rede, backups, atualização e monitoramento. Cloud e self-hosted usam modelos de responsabilidade diferentes; compare o guia de implantação.
O que avaliar antes de usar uma API independente
- Requisito de canal: confirme se seu cliente ou contrato exige a plataforma oficial da Meta.
- Termos e uso permitido: revise as condições do fornecedor, as políticas aplicáveis e a finalidade das mensagens.
- Conexão e recuperação: defina quem verifica o estado da sessão, recebe alertas e reconcilia falhas ou desconexões.
- Segredos e dados: armazene API Keys fora do navegador e reduza o que vai para logs, webhooks e ferramentas de terceiros.
- Teste e limite: comece com baixo volume, contatos autorizados e critérios claros para interromper o fluxo.
Nenhuma página deve prometer que uma conexão independente é imune a bloqueios, instabilidade ou mudanças do WhatsApp. Se a consequência de uma interrupção for alta, desenhe um plano de contingência e valide a escolha com as áreas responsáveis pela operação, privacidade e contratos.
Perguntas frequentes
API de WhatsApp não oficial é a API da Meta?
Não. A expressão costuma identificar uma integração independente com uma sessão do aplicativo. A WhatsApp Business Platform é o produto oficial da Meta e tem configuração, políticas e termos próprios.
A StackZap garante que o número não será bloqueado?
Não. Os Termos StackZap não garantem aprovação de números, ausência de bloqueios ou entrega de todas as mensagens. Avalie os riscos e as condições do WhatsApp para seu caso.
Posso integrar uma API independente ao n8n?
Sim. A StackZap tem um node comunitário publicado no npm para operações de ação; HTTP Request e Webhook do n8n também atendem fluxos compatíveis. Veja o guia de instalação e integração.
Como saber se devo escolher a API oficial?
Liste requisitos obrigatórios e confira diretamente a documentação e os termos da Meta. Se o projeto exige vínculo ou recurso oficial, não presuma que uma API independente seja equivalente.
Onde comparo outras alternativas?
Leia as páginas de avaliação da Evolution API e da Z-API; ambas apontam fontes públicas dos fornecedores e explicam o que precisa ser verificado.
Fontes e atualização
Revisado em . Consulte sempre a versão atual das fontes antes de decidir.
Próximo passo
Se a arquitetura independente atende aos requisitos do seu projeto, leia a documentação e confira as condições vigentes antes de iniciar.