Enviar e receber
Texto, mídia, áudio de voz, enquete, localização, contatos, grupos e status. Tudo via chamadas REST simples, sem o app no celular.
WhatsApp API
WhatsApp API, sem a parte difícil.
Uma WhatsApp API deixa o seu sistema enviar e receber mensagens por código. A Shiftz entrega isso gerenciado: compatível com a Evolution API v2, com servidor MCP nativo e webhooks em tempo real. Você conecta um número e integra em minutos.
O que é
Como uma WhatsApp API funciona.
Na prática, uma WhatsApp API tem três partes: como você manda e recebe mensagens, como autentica as chamadas e como recebe os eventos de volta.
Autenticação por apikey
Cada requisição leva uma chave de API no header. Na Shiftz, a chave pode ser org-wide ou escopada por instância (número).
Webhooks e eventos
Mensagens recebidas, status de entrega e mudanças de conexão chegam no seu endpoint em tempo real, como JSON estruturado.
Oficial vs gerenciada
Cloud API ou WhatsApp API gerenciada?
A oficial (Cloud API da Meta) e a não-oficial gerenciada resolvem o mesmo problema de jeitos diferentes. Veja o trade-off:
| Recurso | WhatsApp Cloud API (Meta) | Shiftz (gerenciada) |
|---|---|---|
| Onboarding | Cadastro na Meta + verificação de negócio | Conecta escaneando o QR Code |
| Custo | Por conversa (Meta) + provedor | Plano fixo por número e volume |
| Mensagem fora da janela de 24h | Só com template aprovado | Mensagem livre (engine não-oficial) |
| Recursos pra dev | REST | REST + servidor MCP + webhooks assinados |
| Padrão de integração | Cloud API (Meta) | Evolution API v2 (compatível) |
Como integrar
Três chamadas pra colocar pra rodar.
bash
# 1. Cria a instância (já pede o QR)curl -X POST https://api.shiftz.com.br/v2/instance/create \ -H "apikey: shz_xxx.yyy" -H "Content-Type: application/json" \ -d '{ "instanceName": "meu-bot", "qrcode": true }' # 2. Conecta e pega o QR (escaneie no celular)curl https://api.shiftz.com.br/v2/instance/connect/meu-bot \ -H "apikey: shz_xxx.yyy" # 3. Manda a primeira mensagem quando o estado virar "open"curl -X POST https://api.shiftz.com.br/v2/message/sendText/meu-bot \ -H "apikey: shz_xxx.yyy" -H "Content-Type: application/json" \ -d '{ "number": "5511999998888", "text": "Olá!" }'O único passo manual é escanear o QR Code: o WhatsApp exige o celular. O resto é REST puro, compatível com a Evolution v2.
Perguntas frequentes
- O que é uma WhatsApp API?
- Uma WhatsApp API é a interface que deixa um sistema enviar e receber mensagens de WhatsApp por código, sem o app no celular. Você integra a API ao seu produto, automação ou agente de IA e passa a operar o WhatsApp de forma programática.
- Qual a diferença entre a API oficial e a não-oficial?
- A oficial (WhatsApp Cloud API, da Meta) exige cadastro de negócio, cobra por conversa e usa templates aprovados fora da janela de 24h. As não-oficiais automatizam o WhatsApp multi-device, são mais simples e baratas pra começar e dão mais liberdade de mensagem, com a contrapartida de seguir as regras de uso do WhatsApp.
- A WhatsApp API é grátis?
- A API em si é um serviço pago. A Shiftz tem trial de 7 dias sem cartão, com 1 instância e 1000 mensagens; depois os planos começam em R$28/mês.
- A Shiftz usa a API oficial do WhatsApp?
- Não. A Shiftz roda sobre engines não-oficiais gerenciadas, no padrão Evolution API v2. É mais simples e barato pra começar. Para casos que exigem a Cloud API oficial, fale com a gente.
- É seguro? Tem risco de ban?
- Toda WhatsApp API não-oficial opera sobre o WhatsApp multi-device e está sujeita às regras do WhatsApp. A Shiftz reduz o risco com infra estável e boas práticas, mas recomendamos uso responsável: contatos opt-in e nada de spam.
- Como integro a WhatsApp API ao meu sistema?
- Você cria uma instância, conecta o número via QR Code e passa a chamar os endpoints /v2/* com sua apikey. Como a Shiftz é compatível com a Evolution v2, qualquer biblioteca ou ferramenta no-code que fale esse padrão funciona.
Coloca o WhatsApp no seu produto.
Cria a conta, conecta um número e manda a primeira mensagem hoje. Trial de 7 dias, sem cartão.