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) oustatus@broadcast(status).file— para mídia, usefile.url(URL pública) oufile.data(base64).reply_to— ID da mensagem à qual você responde.
Marcar como lido
POST /api/sendSeen{
"session": "S0001",
"chatId": "5215551234567@c.us"
}Para ler mensagens específicas, use messageIds (e participant em grupos):
{
"session": "S0001",
"chatId": "5215551234567@c.us",
"messageIds": [
"false_5215551234567@c.us_AAAAAAAAAAAAAAAAAAAA"
]
}Enviar texto
POST /api/sendText{
"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{
"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{
"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{
"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{
"url": "https://ejemplo.com/audio.mp3"
}Converter vídeo
Converte um vídeo para o formato MP4.
POST /api/{session}/media/convert/video{
"url": "https://ejemplo.com/video.avi"
}Enviar arquivo
POST /api/sendFile{
"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{
"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{
"session": "S0001",
"chatId": "5215551234567@c.us",
"pollMessageId": "ID_DE_LA_ENCUESTA",
"pollServerId": null,
"votes": ["Rojo"]
}Enviar lista interativa
POST /api/sendList{
"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{
"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{
"session": "S0001",
"messageId": "false_5215551234567@c.us_ABC123",
"chatId": "5219999999999@c.us"
}Reagir a uma mensagem
PUT /api/reaction{
"session": "S0001",
"messageId": "false_5215551234567@c.us_ABC123",
"reaction": "👍"
}Destacar mensagem
PUT /api/star{
"session": "S0001",
"messageId": "false_5215551234567@c.us_ABC123",
"chatId": "5215551234567@c.us",
"star": true
}Enviar contato
POST /api/sendContactVcard{
"session": "S0001",
"chatId": "5215551234567@c.us",
"contacts": [
{ "fullName": "Juan Pérez", "phoneNumber": "+5215551234567" }
]
}Enviar localização
POST /api/sendLocation{
"session": "S0001",
"chatId": "5215551234567@c.us",
"latitude": 19.4326,
"longitude": -99.1332,
"title": "Cidade do México"
}Indicador de digitação
POST /api/startTyping{
"session": "S0001",
"chatId": "5215551234567@c.us"
}POST /api/stopTyping