v2PainelCriar chave

Envio

Envie texto, mídia, áudio, figurinha, localização, contato, enquete, lista, botões e status para qualquer número do WhatsApp.

POSTTexto

/message/sendText/:instance

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

/message/sendMedia/:instance

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

/message/sendWhatsAppAudio/:instance

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

/message/sendPtv/:instance

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

/message/sendSticker/:instance

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

/message/sendLocation/:instance

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

/message/sendContact/:instance

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

/message/sendPoll/:instance

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

/message/sendList/:instance

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"
        }
      ]
    }
  ]
}'

POSTBotões de resposta

/message/sendButtons/:instance

Até 3 botões de resposta ou de link. Se o WhatsApp recusar, o texto sai com as opções numeradas.

numberstringObrigatório
Para quem vai: código do país + DDD + número, sem espaços nem símbolos. Ex.: 5511999998888.
titlestringObrigatório
Título.
descriptionstringOpcional
Texto.
footerstringOpcional
Rodapé.
buttonsobject[]Obrigatório
{ type: "reply", displayText, id } ou { type: "url", displayText, url }.
curl -X POST https://api.connectdm.app/message/sendButtons/loja \
  -H "apikey: sk_live_SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{
  "number": "5511999998888",
  "title": "Confirma o pedido?",
  "buttons": [
    {
      "type": "reply",
      "displayText": "Sim",
      "id": "ok"
    },
    {
      "type": "reply",
      "displayText": "Não",
      "id": "no"
    }
  ]
}'

POSTStory (status)

/message/sendStatus/:instance

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!"
}'
© 2026 ConnectDM by Centralizer · Referência da API