Skip to main content
POST
/
instances
/
{INSTANCE_ID}
/
token
/
{INSTANCE_TOKEN}
/
send-text
Enviar Texto
curl --request POST \
  --url https://api.example.com/instances/{INSTANCE_ID}/token/{INSTANCE_TOKEN}/send-text

Descrição

Envia uma mensagem de texto simples para um número de WhatsApp ou grupo. Suporta citação de mensagens anteriores, menção de contatos e simulação de digitação.

Request

Headers

Client-Token: SEU_CLIENT_TOKEN
Content-Type: application/json

Body

{
  "phone": "5511999999999",
  "message": "Olá!",
  "messageId": "ID_PARA_REPLY",
  "delayMessage": 1000,
  "delayTyping": 2000,
  "mentioned": ["5511888888888"]
}
CampoTipoObrigatórioDescrição
phonestringSimNúmero do destinatário no formato DDI+DDD+número (ex: 5511999999999)
messagestringSimTexto da mensagem
messageIdstringNãoID de uma mensagem anterior para citar/responder
delayMessagenumberNãoAguarda N milissegundos antes de enviar a mensagem
delayTypingnumberNãoSimula o status “digitando…” por N milissegundos antes de enviar
mentionedarrayNãoLista de números de telefone para mencionar na mensagem

Response

Sucesso (202)

{
  "messageId": "3EB0C767D02DCC481523",
  "id": "3EB0C767D02DCC481523"
}

Exemplo cURL

Texto simples

curl -X POST 'https://api.bliper.io/instances/{INSTANCE_ID}/token/{INSTANCE_TOKEN}/send-text' \
  -H 'Client-Token: SEU_CLIENT_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "phone": "5511999999999",
    "message": "Olá! Como posso ajudar?"
  }'

Texto com reply (citando mensagem anterior)

curl -X POST 'https://api.bliper.io/instances/{INSTANCE_ID}/token/{INSTANCE_TOKEN}/send-text' \
  -H 'Client-Token: SEU_CLIENT_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "phone": "5511999999999",
    "message": "Respondendo sua pergunta...",
    "messageId": "3EB0C767D02DCC481523"
  }'

Mensagem para grupo com menção

curl -X POST 'https://api.bliper.io/instances/{INSTANCE_ID}/token/{INSTANCE_TOKEN}/send-text' \
  -H 'Client-Token: SEU_CLIENT_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "phone": "5511999999999-1234567890@g.us",
    "message": "@5511888888888 você foi mencionado!",
    "mentioned": ["5511888888888"]
  }'
Para grupos, o campo phone deve conter o ID do grupo no formato NÚMERO-TIMESTAMP@g.us.