Skip to main content
POST

Visão Geral

Este endpoint permite disparar mensagens no WhatsApp Oficial (WhatsApp Cloud API) de forma assíncrona. O disparo é processado e enfileirado na infraestrutura de alta performance da WavUps.
[!IMPORTANT] O parâmetro accountIntegrationId é obrigatório. Obtenha o ID correspondente à sua integração de WhatsApp através do endpoint Listar Integrações ou utilize a propriedade accountIntegration retornada no endpoint Listar Setores.

Requisição

POST https://crm.wavups.com/api/v1/whatsapp/send-message
string
required
Seu token de autenticação.

Body

string
required
ID da integração de WhatsApp na sua conta (consulte Listar Integrações ou a propriedade accountIntegration em Listar Setores).
string
required
Número de telefone do destinatário com DDI e DDD, sem o símbolo + (ex: 5511999999999).
string
required
Tipo de mensagem a ser enviada. Valores suportados: text, image, audio, video, document, template, sticker, location, contacts, reaction, interactive.
string
ID do Lead a ser associado à conversa caso a conversa ainda não exista no sistema.
string
ID do usuário da conta que está enviando a mensagem (opcional). Se omitido, a mensagem é registrada como enviada por IA/Automação.

Tipos de Mensagem e Payloads

1. Texto (text)

2. Imagem (image)

3. Áudio (audio)

4. Vídeo (video)

5. Documento / PDF (document)

6. Template (template)

O código do idioma retornado em Listar Templates (campo language, ex: "pt_BR") deve ser informado dentro do objeto language: { "code": "pt_BR" }.

Exemplos de Envio

Authorizations

Token
string
header
required

Token de autenticacao gerado na plataforma WavUps CRM.

Body

application/json
accountIntegrationId
string
required

ID da integração WhatsApp.

to
string
required

Telefone destinatário internacional sem + (ex: 5511999999999).

type
enum<string>
required
Available options:
text,
image,
audio,
video,
document,
template,
sticker,
location,
contacts,
reaction,
interactive
accountCRMLeadId
string

ID do lead opcional caso a conversa ainda não exista.

senderId
string | null

ID do membro da conta enviando a mensagem.

text
object
image
object
audio
object
video
object
document
object
template
object

Response

Mensagem enfileirada com sucesso.

message
string
Example:

"WhatsApp Cloud API message send task queued successfully."