Documentação da API

# Enviar pela sessão padrão
curl -X POST https://use.sendzap.online/api/whatsapp/send \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer SUA_API_KEY" \
  -d '{
    "phone": "5511999999999",
    "message": "Olá! Esta é uma mensagem de teste."
  }'

# Enviar pela sessão de vendas
curl -X POST https://use.sendzap.online/api/whatsapp/send \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer SUA_API_KEY" \
  -d '{
    "sessionName": "vendas",
    "phone": "5511999999999",
    "message": "Olá! Aqui é a equipe de vendas."
  }'

# Enviar pela sessão de suporte
curl -X POST https://use.sendzap.online/api/whatsapp/send \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer SUA_API_KEY" \
  -d '{
    "sessionName": "suporte",
    "phone": "5511999999999",
    "message": "Olá! Aqui é o suporte técnico."
  }'

{
  "success": true,
  "message": "Mensagem enviada com sucesso",
  "messageId": "true_5511999999999@c.us_3EB0A7B4"
}

{
  "success": false,
  "error": "WhatsApp não está conectado."
}

Os disparos são processados em background. Você pode criar um disparo, fechar a página, e acompanhar o progresso depois. Suporta pausar, retomar e cancelar.

curl -X POST https://use.sendzap.online/api/whatsapp/send-bulk \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer SUA_API_KEY" \
  -d '{
    "sessionName": "vendas",
    "name": "Campanha Black Friday",
    "message": "Aproveite nossas promocoes! Ate 50% de desconto.",
    "phones": ["5511999999999", "5511888888888", "5511777777777"],
    "delay": 5000
  }'

{
  "success": true,
  "message": "Disparo criado com sucesso. Processamento iniciado em background.",
  "dispatchId": 1,
  "totalNumbers": 3
}

* keyType do PIX é auto-detectado se omitido. Valores: email, cpf, cnpj, phone, random. Campos opcionais do PIX: currency (padrão: "BRL"), name (beneficiário).

# Exemplo: botão de resposta + link + copiar código
curl -X POST https://use.sendzap.online/api/whatsapp/send-buttons \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer SUA_API_KEY" \
  -d '{
    "sessionName": "vendas",
    "phone": "5511999999999",
    "title": "Promoção Especial",
    "message": "Confira nossa oferta exclusiva! 50% de desconto.",
    "footer": "Válido até 30/01",
    "buttons": [
      {"type": "reply", "text": "Tenho interesse", "id": "btn_interesse"},
      {"type": "url", "text": "Ver Produtos", "url": "https://meusite.com/promo"},
      {"type": "copy", "text": "Copiar Cupom", "copyCode": "PROMO50"}
    ]
  }'

# Exemplo: botão de ligar
curl -X POST https://use.sendzap.online/api/whatsapp/send-buttons \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer SUA_API_KEY" \
  -d '{
    "phone": "5511999999999",
    "title": "Suporte Técnico",
    "message": "Precisa de ajuda? Fale conosco!",
    "buttons": [
      {"type": "reply", "text": "Abrir Ticket", "id": "btn_ticket"},
      {"type": "call", "text": "Ligar Agora", "phoneNumber": "5511988887777"}
    ]
  }'

{
  "success": true,
  "message": "Mensagem com botões enviada com sucesso",
  "messageId": "true_5511999999999@c.us_3EB0A7B4"
}

# Campanha com botões para múltiplos contatos
curl -X POST https://use.sendzap.online/api/whatsapp/send-bulk-buttons \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer SUA_API_KEY" \
  -d '{
    "sessionName": "marketing",
    "name": "Campanha Black Friday",
    "title": "Black Friday!",
    "message": "Aproveite 70% OFF em toda a loja!",
    "footer": "Oferta por tempo limitado",
    "contacts": [
      {"phone": "5511999999999", "name": "João Silva"},
      {"phone": "5511888888888", "name": "Maria Santos"},
      {"phone": "5511777777777", "name": "Pedro Oliveira"}
    ],
    "buttons": [
      {"type": "url", "text": "Ver Ofertas", "url": "https://meusite.com/bf"},
      {"type": "copy", "text": "Copiar Cupom", "copyCode": "BLACK70"},
      {"type": "reply", "text": "Quero saber mais", "id": "btn_info"}
    ],
    "delayMs": 5000,
    "batchEnabled": true,
    "batchSize": 50,
    "batchDelay": 60000
  }'

# Cobrança via PIX em massa
curl -X POST https://use.sendzap.online/api/whatsapp/send-bulk-buttons \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer SUA_API_KEY" \
  -d '{
    "name": "Cobrança Mensal",
    "title": "Fatura Disponível",
    "message": "Sua fatura está pronta. Pague via PIX com desconto!",
    "contacts": [
      {"phone": "5511999999999", "name": "Cliente 1"},
      {"phone": "5511888888888", "name": "Cliente 2"}
    ],
    "buttons": [
      {"type": "pix", "key": "financeiro@empresa.com", "amount": 5000}
    ],
    "delayMs": 3000
  }'

Nota: Botões do tipo pix são automaticamente enviados via o novo formato sendPaymentOrder da Evolution API. O campo amount é em centavos (5000 = R$ 50,00).

{
  "success": true,
  "message": "Disparo com botões criado com sucesso",
  "dispatchId": 15,
  "totalContacts": 3,
  "estimatedTime": "15 segundos"
}

Envia imagem, vídeo, áudio ou documento para um número. Aceita URL pública ou base64.

# Enviar imagem por URL
curl -X POST https://use.sendzap.online/api/whatsapp/send-media \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer SUA_API_KEY" \
  -d '{
    "sessionName": "vendas",
    "phone": "5511999999999",
    "mediatype": "image",
    "media": "https://meusite.com/banner.jpg",
    "caption": "Confira nossa promoção de Black Friday! 🎉"
  }'

# Enviar PDF por URL
curl -X POST https://use.sendzap.online/api/whatsapp/send-media \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer SUA_API_KEY" \
  -d '{
    "phone": "5511999999999",
    "mediatype": "document",
    "media": "https://meusite.com/catalogo.pdf",
    "caption": "Segue nosso catálogo completo",
    "fileName": "Catalogo2025.pdf"
  }'

# Enviar imagem em base64
curl -X POST https://use.sendzap.online/api/whatsapp/send-media \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer SUA_API_KEY" \
  -d '{
    "phone": "5511999999999",
    "mediatype": "image",
    "mediaBase64": "data:image/jpeg;base64,/9j/4AAQSkZJRg...",
    "caption": "Imagem enviada do servidor"
  }'

{
  "success": true,
  "message": "Mídia enviada com sucesso",
  "messageId": "BAE5A75CB0F39712"
}

Cria um disparo em massa enviando mídia (imagem, vídeo, documento, áudio) para uma lista de contatos. Processa em background.

# Disparo de imagem por URL com legenda personalizada
curl -X POST https://use.sendzap.online/api/whatsapp/send-bulk-media \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer SUA_API_KEY" \
  -d '{
    "sessionName": "marketing",
    "name": "Campanha Black Friday",
    "contacts": [
      {"phone": "5511999999999", "name": "Maria"},
      {"phone": "5511888888888", "name": "João"}
    ],
    "mediatype": "image",
    "media": "https://meusite.com/banner-bf.jpg",
    "caption": "Olá {{nome}}! 🎉 Black Friday com até 70% OFF. Garanta já o seu!",
    "delayMs": 15000,
    "batchEnabled": true,
    "batchSize": 10,
    "batchDelay": 300000
  }'

# Disparo de PDF
curl -X POST https://use.sendzap.online/api/whatsapp/send-bulk-media \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer SUA_API_KEY" \
  -d '{
    "name": "Envio Catalogo",
    "phones": ["5511999999999", "5511888888888"],
    "mediatype": "document",
    "media": "https://meusite.com/catalogo.pdf",
    "caption": "Segue o catálogo com nossos produtos",
    "fileName": "Catalogo2025.pdf",
    "delayMs": 20000
  }'

{
  "success": true,
  "message": "Disparo de mídia criado com sucesso.",
  "dispatchId": 42,
  "totalNumbers": 150,
  "mediatype": "image"
}

O disparo processa em background. Use GET /whatsapp/send-bulk/:id para acompanhar o progresso. Recomendação: prefira sempre URL pública para vídeos — base64 de vídeos ocupa muito espaço no banco de dados.

Envia áudio para um número. Por padrão chega como mensagem de voz (PTT) — com ícone de microfone e forma de onda, como se tivesse sido gravada na hora, e o destinatário vê "gravando áudio..." antes de receber. O áudio é convertido automaticamente para o formato nativo do WhatsApp (ogg/opus), então você pode enviar mp3, wav, m4a, ogg ou opus.

# Áudio GRAVADO (PTT) por URL — comportamento padrão
curl -X POST https://use.sendzap.online/api/whatsapp/send-audio \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer SUA_API_KEY" \
  -d '{
    "sessionName": "vendas",
    "phone": "5511999999999",
    "audio": "https://meusite.com/boas-vindas.mp3",
    "audioType": "recorded"
  }'

# Áudio como ARQUIVO (player de música, não voz)
curl -X POST https://use.sendzap.online/api/whatsapp/send-audio \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer SUA_API_KEY" \
  -d '{
    "phone": "5511999999999",
    "audio": "https://meusite.com/podcast-ep1.mp3",
    "audioType": "file"
  }'

# Upload direto do arquivo (multipart/form-data — sem precisar de URL nem base64)
curl -X POST https://use.sendzap.online/api/whatsapp/send-audio \
  -H "Authorization: Bearer SUA_API_KEY" \
  -F "phone=5511999999999" \
  -F "audioType=recorded" \
  -F "file=@/caminho/do/audio.mp3"

# Áudio gravado em base64
curl -X POST https://use.sendzap.online/api/whatsapp/send-audio \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer SUA_API_KEY" \
  -d '{
    "phone": "5511999999999",
    "audioBase64": "data:audio/mpeg;base64,SUQzBAAAAAAA..."
  }'

{
  "success": true,
  "message": "Mídia enviada com sucesso",
  "messageId": "BAE5A75CB0F39712"
}

O campo asVoice (bool) continua aceito como alternativa ao audioType. Tamanho máximo: 50MB no upload; recomendado até 16MB (limite do WhatsApp para áudio).

Cria um disparo em massa de áudio para uma lista de contatos. Por padrão cada contato recebe como mensagem de voz (PTT). Processa em background com os mesmos controles do disparo de mídia: delay entre envios, lotes e pausa noturna.

# Disparo de mensagem de voz com texto complementar
curl -X POST https://use.sendzap.online/api/whatsapp/send-bulk-audio \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer SUA_API_KEY" \
  -d '{
    "sessionName": "marketing",
    "name": "Convite em Audio",
    "contacts": [
      {"phone": "5511999999999", "name": "Maria"},
      {"phone": "5511888888888", "name": "João"}
    ],
    "audio": "https://meusite.com/convite.mp3",
    "caption": "Olá {{nome}}! Ouça o convite especial que gravamos para você 🎧",
    "delayMs": 15000
  }'

{
  "success": true,
  "message": "Disparo de mídia criado com sucesso.",
  "dispatchId": 43,
  "totalNumbers": 2,
  "mediatype": "audio"
}

Recomendação: para listas grandes use sempre audio (URL pública) em vez de base64 — o base64 fica armazenado no banco e é reprocessado a cada contato.

Envia uma mensagem rica com imagem (opcional), texto, título, rodapé e até 3 botões interativos: resposta rápida, abrir link, ligar ou copiar código. Sem imagem, envia texto + botões.

Estrutura de cada botão:

# Imagem por URL + 3 botões
curl -X POST https://use.sendzap.online/api/whatsapp/send-media-buttons \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer SUA_API_KEY" \
  -d '{
    "sessionName": "vendas",
    "phone": "5511999999999",
    "imageUrl": "https://meusite.com/banner.jpg",
    "title": "Promoção Especial",
    "caption": "Aproveite 50% OFF em todos os produtos até domingo!",
    "footer": "Powered by SendZap",
    "buttons": [
      {"type": "url",   "text": "Ver Ofertas",  "url": "https://meusite.com/ofertas"},
      {"type": "copy",  "text": "Copiar Cupom", "copyCode": "DESCONTO50"},
      {"type": "reply", "text": "Falar com Vendedor"}
    ]
  }'

# Imagem em base64 (upload direto, sem hospedar)
curl -X POST https://use.sendzap.online/api/whatsapp/send-media-buttons \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer SUA_API_KEY" \
  -d '{
    "phone": "5511999999999",
    "imageBase64": "data:image/jpeg;base64,/9j/4AAQSkZJRg...",
    "caption": "Confira o catálogo desta semana!",
    "buttons": [
      {"type": "call", "text": "Ligar Agora", "phoneNumber": "5511988887777"}
    ]
  }'

{
  "success": true,
  "message": "Mensagem enviada com sucesso",
  "messageId": "BAE5A75CB0F39712"
}

Cria um disparo em massa de imagem + texto + botões interativos. Processa em background com delay entre envios, lotes e pausa noturna.

curl -X POST https://use.sendzap.online/api/whatsapp/send-bulk-media-buttons \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer SUA_API_KEY" \
  -d '{
    "sessionName": "marketing",
    "name": "Campanha Cupom",
    "contacts": [
      {"phone": "5511999999999", "name": "Maria"},
      {"phone": "5511888888888", "name": "João"}
    ],
    "imageUrl": "https://meusite.com/banner-cupom.jpg",
    "title": "Oferta Exclusiva",
    "caption": "Olá {{nome}}! Liberamos um cupom exclusivo para você 🎁",
    "footer": "Válido até domingo",
    "buttons": [
      {"type": "url",  "text": "Comprar Agora", "url": "https://meusite.com/loja"},
      {"type": "copy", "text": "Copiar Cupom",  "copyCode": "VIP20"}
    ],
    "delayMs": 15000,
    "batchEnabled": true,
    "batchSize": 20,
    "batchDelay": 120000
  }'

{
  "success": true,
  "message": "Disparo Imagem+Botões criado com sucesso.",
  "dispatchId": 44,
  "totalNumbers": 2
}

Acompanhe o progresso com GET /whatsapp/send-bulk/:id.

Envia um pagamento PIX usando o novo formato sendPaymentOrder da Evolution API. Gera um botão nativo de pagamento no WhatsApp.

# Enviar PIX por e-mail
curl -X POST https://use.sendzap.online/api/whatsapp/send-pix \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer SUA_API_KEY" \
  -d '{
    "phone": "5511999999999",
    "pixKey": "pix@minhaloja.com",
    "amount": 5000,
    "merchantName": "Minha Loja"
  }'

# Enviar PIX por CPF (keyType auto-detectado)
curl -X POST https://use.sendzap.online/api/whatsapp/send-pix \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer SUA_API_KEY" \
  -d '{
    "phone": "5511999999999",
    "pixKey": "12345678901",
    "amount": 15000
  }'

{
  "success": true,
  "message": "PIX enviado com sucesso",
  "messageId": "3EB0A7B4..."
}