Envio
Envie texto, mídia, áudio, figurinha, localização, contato, enquete, lista, botões e status para qualquer número do WhatsApp.
POSTTexto
Manda texto puro, com emoji, @menções e prévia de link opcional.
numberstringObrigatório- Para quem vai: código do país + DDD + número, sem espaços nem símbolos. Ex.: 5511999998888.
textstringObrigatório- Texto da mensagem (até 4096 caracteres). Para mencionar, escreva @5511… no texto.
delaynumberOpcional- Atraso em milissegundos antes de enviar (máx: 15000). Mostra "digitando…" durante a espera.
mentionedstring[]Opcional- Números ou JIDs mencionados (até 1024).
mentionsEveryOnebooleanOpcional- Em grupos, menciona todos os participantes.
linkPreviewbooleanOpcional- Mostra a prévia do primeiro link http(s) do texto.
linkPreviewTitlestringOpcional- Título da prévia (padrão: domínio do site).
linkPreviewDescriptionstringOpcional- Descrição da prévia.
linkPreviewImagestringOpcional- Imagem da prévia: URL, data URI ou base64 (JPEG, PNG ou GIF, até 5 MiB).
linkPreviewLargebooleanOpcional- Envia a imagem em tamanho maior para o card grande (quem decide a exibição é o app de quem recebe).
quotedobjectOpcional- Mensagem a responder: { key: { id } }. Em grupos, informe também key.participant.
curl -X POST https://api.connectdm.app/message/sendText/loja \
-H "apikey: sk_live_SUA_CHAVE" \
-H "Content-Type: application/json" \
-d '{
"number": "5511999998888",
"text": "Olá do ConnectDM 👋",
"delay": 1200
}'POSTImagem, vídeo ou arquivo
Envia imagem, vídeo ou documento a partir de uma URL pública ou de base64 (até ~5 MB).
numberstringObrigatório- Para quem vai: código do país + DDD + número, sem espaços nem símbolos. Ex.: 5511999998888.
mediatypestringObrigatório- Tipo do arquivo: image, video ou document.
mediastringObrigatório- URL pública, data URI (data:image/png;base64,…) ou base64 puro com mimetype.
captionstringOpcional- Legenda.
fileNamestringOpcional- Nome exibido para documentos.
mimetypestringOpcional- MIME type; obrigatório com base64 puro e precisa combinar com mediatype.
delaynumberOpcional- Atraso em milissegundos antes de enviar (máx: 15000). Mostra "digitando…" durante a espera.
quotedobjectOpcional- Mensagem a responder: { key: { id } }. Em grupos, informe também key.participant.
curl -X POST https://api.connectdm.app/message/sendMedia/loja \
-H "apikey: sk_live_SUA_CHAVE" \
-H "Content-Type: application/json" \
-d '{
"number": "5511999998888",
"mediatype": "image",
"media": "https://exemplo.com/produto.png",
"caption": "Confira!"
}'POSTMensagem de voz
Envia um áudio como mensagem de voz gravada na hora.
numberstringObrigatório- Para quem vai: código do país + DDD + número, sem espaços nem símbolos. Ex.: 5511999998888.
audiostringObrigatório- URL pública do MP3 ou OGG.
delaynumberOpcional- Atraso em milissegundos antes de enviar (máx: 15000). Mostra "digitando…" durante a espera.
quotedobjectOpcional- Mensagem a responder: { key: { id } }. Em grupos, informe também key.participant.
curl -X POST https://api.connectdm.app/message/sendWhatsAppAudio/loja \
-H "apikey: sk_live_SUA_CHAVE" \
-H "Content-Type: application/json" \
-d '{
"number": "5511999998888",
"audio": "https://exemplo.com/recado.ogg"
}'POSTVídeo em círculoNovo
Envia um vídeo como recado em círculo, igual ao gravado no app. Recomendado até 60 segundos.
numberstringObrigatório- Para quem vai: código do país + DDD + número, sem espaços nem símbolos. Ex.: 5511999998888.
videostringObrigatório- URL pública, data URI ou base64 de um MP4.
mimetypestringOpcional- Padrão video/mp4.
delaynumberOpcional- Atraso em milissegundos antes de enviar (máx: 15000). Mostra "digitando…" durante a espera.
quotedobjectOpcional- Mensagem a responder: { key: { id } }. Em grupos, informe também key.participant.
curl -X POST https://api.connectdm.app/message/sendPtv/loja \
-H "apikey: sk_live_SUA_CHAVE" \
-H "Content-Type: application/json" \
-d '{
"number": "5511999998888",
"video": "https://exemplo.com/recado.mp4"
}'POSTFigurinha
Envia uma figurinha a partir de uma imagem WebP (outros formatos são convertidos).
numberstringObrigatório- Para quem vai: código do país + DDD + número, sem espaços nem símbolos. Ex.: 5511999998888.
stickerstringObrigatório- URL pública da imagem.
delaynumberOpcional- Atraso em milissegundos antes de enviar (máx: 15000). Mostra "digitando…" durante a espera.
curl -X POST https://api.connectdm.app/message/sendSticker/loja \
-H "apikey: sk_live_SUA_CHAVE" \
-H "Content-Type: application/json" \
-d '{
"number": "5511999998888",
"sticker": "https://exemplo.com/figurinha.webp"
}'POSTPonto no mapa
Envia um ponto no mapa.
numberstringObrigatório- Para quem vai: código do país + DDD + número, sem espaços nem símbolos. Ex.: 5511999998888.
latitudenumberObrigatório- Latitude em graus.
longitudenumberObrigatório- Longitude em graus.
namestringOpcional- Nome do local.
addressstringOpcional- Endereço exibido.
delaynumberOpcional- Atraso em milissegundos antes de enviar (máx: 15000). Mostra "digitando…" durante a espera.
curl -X POST https://api.connectdm.app/message/sendLocation/loja \
-H "apikey: sk_live_SUA_CHAVE" \
-H "Content-Type: application/json" \
-d '{
"number": "5511999998888",
"latitude": -23.5614,
"longitude": -46.6559,
"name": "Loja Paulista",
"address": "Av. Paulista, 1000"
}'POSTCartão de contato
Compartilha contatos que a pessoa salva com um toque.
numberstringObrigatório- Para quem vai: código do país + DDD + número, sem espaços nem símbolos. Ex.: 5511999998888.
contactobject[]Obrigatório- Lista de { fullName, phoneNumber, organization?, email?, url? }.
curl -X POST https://api.connectdm.app/message/sendContact/loja \
-H "apikey: sk_live_SUA_CHAVE" \
-H "Content-Type: application/json" \
-d '{
"number": "5511999998888",
"contact": [
{
"fullName": "Suporte Loja",
"phoneNumber": "5511988887777"
}
]
}'POSTEnquete
Envia uma enquete. Cada voto dispara poll.vote no webhook; a contagem sai em Resultado da Enquete.
numberstringObrigatório- Para quem vai: código do país + DDD + número, sem espaços nem símbolos. Ex.: 5511999998888.
namestringObrigatório- Pergunta.
valuesstring[]Obrigatório- De 2 a 12 opções.
selectableCountnumberOpcional- 0 ou 1 = escolha única; N = até N opções.
delaynumberOpcional- Atraso em milissegundos antes de enviar (máx: 15000). Mostra "digitando…" durante a espera.
curl -X POST https://api.connectdm.app/message/sendPoll/loja \
-H "apikey: sk_live_SUA_CHAVE" \
-H "Content-Type: application/json" \
-d '{
"number": "5511999998888",
"name": "Qual horário prefere?",
"values": [
"Manhã",
"Tarde",
"Noite"
],
"selectableCount": 1
}'POSTMenu de opções
Envia um menu de opções. A escolha chega no webhook com o rowId que você definiu.
numberstringObrigatório- Para quem vai: código do país + DDD + número, sem espaços nem símbolos. Ex.: 5511999998888.
titlestringObrigatório- Linha em negrito no topo do menu.
descriptionstringOpcional- Texto da mensagem.
buttonTextstringObrigatório- O que está escrito no botão que abre o menu.
footerTextstringOpcional- Rodapé.
sectionsobject[]Obrigatório- Seções com rows: { title, description?, rowId }. Até 10 linhas.
curl -X POST https://api.connectdm.app/message/sendList/loja \
-H "apikey: sk_live_SUA_CHAVE" \
-H "Content-Type: application/json" \
-d '{
"number": "5511999998888",
"title": "Atendimento",
"buttonText": "Escolher",
"sections": [
{
"title": "Assuntos",
"rows": [
{
"title": "Pedidos",
"rowId": "pedidos"
},
{
"title": "Trocas",
"rowId": "trocas"
}
]
}
]
}'POSTStory (status)
Publica um status (story) de texto, imagem, vídeo ou áudio.
typestringObrigatório- Formato do story: text, image, video ou audio.
contentstringObrigatório- O texto, ou a URL da mídia.
captionstringOpcional- Texto que aparece junto da imagem ou do vídeo.
curl -X POST https://api.connectdm.app/message/sendStatus/loja \
-H "apikey: sk_live_SUA_CHAVE" \
-H "Content-Type: application/json" \
-d '{
"type": "text",
"content": "Promoção só hoje!"
}'