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

Documentation Index

Fetch the complete documentation index at: https://docs.bliper.ai/llms.txt

Use this file to discover all available pages before exploring further.

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.