Send Text Message

Send a text message to a WhatsApp number via Evolution API

Send Text Message

Send a text message to a WhatsApp contact or group. You can include link previews, quoted messages, mentions, and delays.

Endpoint

POST /message/sendText/:instanceName

Path Parameters

instanceName · string · required

The name of your WhatsApp instance that you created

Request Body

number · string · required

The recipient’s WhatsApp number in international format (without + symbol)

Example: 5511999999999 for a Brazilian number

text · string · required

The text message content you want to send

delay · integer

Delay before sending the message in milliseconds

Example: 1000 for 1 second delay

linkPreview · boolean

Enable or disable link preview for URLs in the message

Default: true

quoted · object

Quote a previous message by providing its key and message object

mentionsEveryOne · boolean

Mention all participants in a group (use with caution)

Default: false

mentioned · array

Array of phone numbers to mention in the message. Each number should be a numeric string.

Example: ["5511999999999", "5511888888888"]

Response

key · object

Message key information

message · object

The sent message object containing the text and metadata

messageTimestamp · string

Unix timestamp when the message was sent

status · string

Message status (e.g., “PENDING”, “SENT”)

Code Examples

cURL

curl -X POST https://your-api-url.com/message/sendText/my-instance \
  -H "Content-Type: application/json" \
  -H "apikey: YOUR_API_KEY" \
  -d '{
    "number": "5511999999999",
    "text": "Hello! This is a test message from Evolution API."
  }'

const response = await fetch('https://your-api-url.com/message/sendText/my-instance', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'apikey': 'YOUR_API_KEY'
  },
  body: JSON.stringify({
    number: '5511999999999',
    text: 'Hello! This is a test message from Evolution API.'
  })
});

const data = await response.json();
console.log(data);

import requests

url = 'https://your-api-url.com/message/sendText/my-instance'
headers = {
    'Content-Type': 'application/json',
    'apikey': 'YOUR_API_KEY'
}
payload = {
    'number': '5511999999999',
    'text': 'Hello! This is a test message from Evolution API.'
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())

<?php
$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => 'https://your-api-url.com/message/sendText/my-instance',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS => json_encode([
    'number' => '5511999999999',
    'text' => 'Hello! This is a test message from Evolution API.'
  ]),
  CURLOPT_HTTPHEADER => [
    'Content-Type: application/json',
    'apikey: YOUR_API_KEY'
  ],
]);

$response = curl_exec($curl);
curl_close($curl);
echo $response;
?>

Advanced Examples

Send text with mentions

{
  "number": "5511999999999",
  "text": "Hey @5511888888888, check this out!",
  "mentioned": ["5511888888888"]
}

Send text with quoted message

{
  "number": "5511999999999",
  "text": "Replying to your previous message",
  "quoted": {
    "key": {
      "id": "BAE5F2D3E4F5A6B7",
      "remoteJid": "[e-mail]",
      "fromMe": false
    },
    "message": {
      "conversation": "Original message text"
    }
  }
}

Send text with delay and link preview

{
  "number": "5511999999999",
  "text": "Check out this link: https://evolution-api.com",
  "linkPreview": true,
  "delay": 2000
}

Error Responses

Make sure your instance is connected before sending messages. Use the instance status endpoint to verify connection.

status · number

HTTP status code

message · string

Error description

Common Errors

Status Code	Description
400	Bad Request - Invalid payload or missing required fields
401	Unauthorized - Invalid or missing API key
404	Not Found - Instance does not exist
500	Internal Server Error - Server-side error

The number field should contain only digits in international format without the + symbol. For example, use 5511999999999 instead of [phone].