Skip to main content
  1. Uma conta criada (sem cartão de crédito).
  2. Seu WhatsApp conectado na nuvem.
  3. Uma API Key gerada.
  4. Sua primeira mensagem enviada via código.

Criando sua conta

O primeiro passo é acessar nosso dashboard. Não pedimos cartão de crédito para começar. Criar conta no Dashboard Zenvio Para que você possa testar e homologar sua aplicação sem medo, nosso plano gratuito é generoso: 500 mensagens/mês.
Dica: Seus limites resetam mensalmente. Use à vontade para testar!

Conectando seu WhatsApp

A “mágica” da Zenvio acontece através de instâncias. Pense em uma Instância como uma sessão do WhatsApp Web que roda nos nossos servidores, 24h por dia, sem fechar a aba. Logo após criar sua conta e completar o onboarding você já pode dar o nome para sua instância e ler o QR Code que aparecerá na tela.
Abra o WhatsApp no seu celular, vá em Aparelhos Conectados > Conectar Aparelho e escaneie o código.

Gerando sua API Key

Para que seu código converse com a Zenvio com segurança, você precisa de uma chave de acesso. Logo após escanear o QR Code o sistema recomenda criar sua API Key, basta clicar no botão e continuar. Você também pode acessar o menu e clicar em API Keys > New API Key. Defina um nome (ex: “Minha App Local”) e as permissões. Recomendamos o princípio do menor privilégio.
Atenção: Sua chave começará com sk_live_… Copie e guarde-a em um gerenciador de senhas ou no seu .env. Por segurança, não armazenamos a chave completa e não mostramos novamente.

Seu primeiro código

Chegou a hora da verdade. Escolha sua linguagem preferida e envie sua primeira mensagem. Endpoints: POST https://api.zenvio.dev/v1/whatsapp/messages/send

cURL (Terminal)

A maneira mais rápida de testar se tudo está funcionando.
curl -X POST https://api.zenvio.dev/v1/whatsapp/messages/send \
  -H "Authorization: Bearer sk_live_sua_chave_aqui" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "5511999999999",
    "type": "text",
    "content": "Olá! Esta é minha primeira mensagem via Zenvio 🚀"
  }'

Checklist de sucesso

Se você seguiu os passos acima, seu setup está completo!
  • Conta Criada: Você tem acesso ao Dashboard.
  • WhatsApp Conectado: O status da instância está ACTIVE.
  • API Key Gerada: Você tem seu token sk_live_... salvo.
  • Primeira Mensagem: Você recebeu um HTTP 202 Accepted e a mensagem chegou no celular.
Parabéns! Você acabou de economizar semanas de desenvolvimento. Agora, que tal aprender a enviar imagens, arquivos ou usar templates variáveis?