Skip to Content
Wazend

Enviar mensagens

Envie e gerencie mensagens de WhatsApp com a Wazend: texto, mídia, enquetes, listas, botões, reações e mais.

Envie e gerencie mensagens de WhatsApp a partir da sua aplicação.

Campos comuns

  • session — nome da sessão da qual você envia a mensagem.
  • chatId — identificador do destino: 5215551234567@c.us (usuário), ...@g.us (grupo), ...@newsletter (canal) ou status@broadcast (status).
  • file — para mídia, use file.url (URL pública) ou file.data (base64).
  • reply_to — ID da mensagem à qual você responde.

Marcar como lido

POST /api/sendSeen
Corpo
{
  "session": "S0001",
  "chatId": "5215551234567@c.us"
}

Para ler mensagens específicas, use messageIds (e participant em grupos):

Corpo
{
  "session": "S0001",
  "chatId": "5215551234567@c.us",
  "messageIds": [
    "false_5215551234567@c.us_AAAAAAAAAAAAAAAAAAAA"
  ]
}

Enviar texto

POST /api/sendText
Corpo
{
  "session": "S0001",
  "chatId": "5215551234567@c.us",
  "text": "Olá!"
}

Opções adicionais:

  • reply_to — responder a uma mensagem.
  • mentions — mencionar contatos num grupo (["5215551234567@c.us"] ou ["all"] para todos).
  • linkPreview — ativar pré-visualização de links.
  • linkPreviewHighQuality — pré-visualização em alta qualidade.

Enviar imagem

POST /api/sendImage
Corpo
{
  "session": "S0001",
  "chatId": "5215551234567@c.us",
  "file": {
    "mimetype": "image/jpeg",
    "url": "https://ejemplo.com/foto.jpg",
    "filename": "foto.jpg"
  },
  "caption": "Mira esta imagen"
}

Você também pode enviar o arquivo em base64 usando file.data em vez de file.url.

Formato de imagem

O WhatsApp funciona melhor com imagens em JPEG. Não há flag convert para imagens: você deve converter para JPEG antes de enviá-las.

Enviar nota de voz

POST /api/sendVoice
Corpo
{
  "session": "S0001",
  "chatId": "5215551234567@c.us",
  "file": {
    "mimetype": "audio/ogg; codecs=opus",
    "url": "https://ejemplo.com/audio.ogg"
  },
  "convert": false
}

Use convert: true para que a Wazend converta o áudio automaticamente. Você também pode enviar o arquivo em base64 com file.data.

Enviar vídeo

POST /api/sendVideo
Corpo
{
  "session": "S0001",
  "chatId": "5215551234567@c.us",
  "file": {
    "mimetype": "video/mp4",
    "url": "https://ejemplo.com/video.mp4"
  },
  "caption": "Mira este video",
  "convert": false
}

Use convert: true para que a Wazend converta o vídeo automaticamente.

Converter voz

Converte um áudio para um formato compatível com o WhatsApp (OGG/Opus).

POST /api/{session}/media/convert/voice
Corpo
{
  "url": "https://ejemplo.com/audio.mp3"
}

Converter vídeo

Converte um vídeo para o formato MP4.

POST /api/{session}/media/convert/video
Corpo
{
  "url": "https://ejemplo.com/video.avi"
}

Enviar arquivo

POST /api/sendFile
Corpo
{
  "session": "S0001",
  "chatId": "5215551234567@c.us",
  "file": {
    "mimetype": "application/pdf",
    "url": "https://ejemplo.com/documento.pdf",
    "filename": "documento.pdf"
  },
  "caption": "Aqui está o documento"
}

Enviar enquete

POST /api/sendPoll
Corpo
{
  "session": "S0001",
  "chatId": "5215551234567@c.us",
  "poll": {
    "name": "Qual é a sua cor favorita?",
    "options": ["Rojo", "Azul", "Verde"],
    "multipleAnswers": false
  }
}

Votar em enquete

POST /api/sendPollVote
Corpo
{
  "session": "S0001",
  "chatId": "5215551234567@c.us",
  "pollMessageId": "ID_DE_LA_ENCUESTA",
  "pollServerId": null,
  "votes": ["Rojo"]
}

Enviar lista interativa

POST /api/sendList
Corpo
{
  "session": "S0001",
  "chatId": "5215551234567@c.us",
  "message": {
    "title": "Menu principal",
    "description": "Escolha uma opção",
    "footer": "Wazend",
    "button": "Abrir menu",
    "sections": [
      {
        "title": "Opções",
        "rows": [
          { "title": "Opção 1", "rowId": "opcao-1", "description": "Descrição 1" },
          { "title": "Opção 2", "rowId": "opcao-2", "description": "Descrição 2" }
        ]
      }
    ]
  }
}

Enviar link com pré-visualização personalizada

POST /api/send/link-custom-preview
Corpo
{
  "session": "S0001",
  "chatId": "5215551234567@c.us",
  "text": "Veja isto: https://exemplo.com",
  "linkPreviewHighQuality": true,
  "preview": {
    "url": "https://ejemplo.com",
    "title": "Título personalizado",
    "description": "Descrição do link",
    "image": { "url": "https://ejemplo.com/preview.jpg" }
  }
}

Encaminhar mensagem

POST /api/forwardMessage
Corpo
{
  "session": "S0001",
  "messageId": "false_5215551234567@c.us_ABC123",
  "chatId": "5219999999999@c.us"
}

Reagir a uma mensagem

PUT /api/reaction
Corpo
{
  "session": "S0001",
  "messageId": "false_5215551234567@c.us_ABC123",
  "reaction": "👍"
}

Destacar mensagem

PUT /api/star
Corpo
{
  "session": "S0001",
  "messageId": "false_5215551234567@c.us_ABC123",
  "chatId": "5215551234567@c.us",
  "star": true
}

Enviar contato

POST /api/sendContactVcard
Corpo
{
  "session": "S0001",
  "chatId": "5215551234567@c.us",
  "contacts": [
    { "fullName": "Juan Pérez", "phoneNumber": "+5215551234567" }
  ]
}

Enviar localização

POST /api/sendLocation
Corpo
{
  "session": "S0001",
  "chatId": "5215551234567@c.us",
  "latitude": 19.4326,
  "longitude": -99.1332,
  "title": "Cidade do México"
}

Indicador de digitação

POST /api/startTyping
Corpo
{
  "session": "S0001",
  "chatId": "5215551234567@c.us"
}
POST /api/stopTyping

Dica

Para enviar a canais use o chatId com o sufixo @newsletter. Para status use status@broadcast (consulte Canais e Status).