Enviando Mensagens

curl --request POST \
  --url https://api.zapsterapi.com/v1/wa/messages \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "recipient": "group:123456789987654321",
  "text": "<string>",
  "instance_id": "ozj35qv418rpmlrb",
  "auto_delete": false,
  "auto_mention": true,
  "view_once": false,
  "reply_to": "3EB04E7F387C999A0DD61D",
  "link_preview": false,
  "mentions": "everyone",
  "buttons": [
    {
      "label": "Sim, quero!",
      "type": "reply",
      "id": "<string>",
      "phone_number": "+5511999999999",
      "url": "https://exemplo.com/produto",
      "copy_code": "PROMO2024"
    }
  ],
  "buttons_mode": "auto",
  "send_at": "2026-03-30T09:00:00-03:00",
  "media": {
    "url": "https://images.unsplash.com/photo-1721332155567-55d1b12aa271?q=80&w=920&format=jpeg&fit=crop",
    "base64": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg==",
    "caption": "<string>",
    "playback": false,
    "ptt": true,
    "ptv": false,
    "sticker": false,
    "fileName": "<string>"
  }
}
'

import requests

url = "https://api.zapsterapi.com/v1/wa/messages"

payload = {
    "recipient": "group:123456789987654321",
    "text": "<string>",
    "instance_id": "ozj35qv418rpmlrb",
    "auto_delete": False,
    "auto_mention": True,
    "view_once": False,
    "reply_to": "3EB04E7F387C999A0DD61D",
    "link_preview": False,
    "mentions": "everyone",
    "buttons": [
        {
            "label": "Sim, quero!",
            "type": "reply",
            "id": "<string>",
            "phone_number": "+5511999999999",
            "url": "https://exemplo.com/produto",
            "copy_code": "PROMO2024"
        }
    ],
    "buttons_mode": "auto",
    "send_at": "2026-03-30T09:00:00-03:00",
    "media": {
        "url": "https://images.unsplash.com/photo-1721332155567-55d1b12aa271?q=80&w=920&format=jpeg&fit=crop",
        "base64": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg==",
        "caption": "<string>",
        "playback": False,
        "ptt": True,
        "ptv": False,
        "sticker": False,
        "fileName": "<string>"
    }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    recipient: 'group:123456789987654321',
    text: '<string>',
    instance_id: 'ozj35qv418rpmlrb',
    auto_delete: false,
    auto_mention: true,
    view_once: false,
    reply_to: '3EB04E7F387C999A0DD61D',
    link_preview: false,
    mentions: 'everyone',
    buttons: [
      {
        label: 'Sim, quero!',
        type: 'reply',
        id: '<string>',
        phone_number: '+5511999999999',
        url: 'https://exemplo.com/produto',
        copy_code: 'PROMO2024'
      }
    ],
    buttons_mode: 'auto',
    send_at: '2026-03-30T09:00:00-03:00',
    media: {
      url: 'https://images.unsplash.com/photo-1721332155567-55d1b12aa271?q=80&w=920&format=jpeg&fit=crop',
      base64: 'iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg==',
      caption: '<string>',
      playback: false,
      ptt: true,
      ptv: false,
      sticker: false,
      fileName: '<string>'
    }
  })
};

fetch('https://api.zapsterapi.com/v1/wa/messages', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.zapsterapi.com/v1/wa/messages",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'recipient' => 'group:123456789987654321',
    'text' => '<string>',
    'instance_id' => 'ozj35qv418rpmlrb',
    'auto_delete' => false,
    'auto_mention' => true,
    'view_once' => false,
    'reply_to' => '3EB04E7F387C999A0DD61D',
    'link_preview' => false,
    'mentions' => 'everyone',
    'buttons' => [
        [
                'label' => 'Sim, quero!',
                'type' => 'reply',
                'id' => '<string>',
                'phone_number' => '+5511999999999',
                'url' => 'https://exemplo.com/produto',
                'copy_code' => 'PROMO2024'
        ]
    ],
    'buttons_mode' => 'auto',
    'send_at' => '2026-03-30T09:00:00-03:00',
    'media' => [
        'url' => 'https://images.unsplash.com/photo-1721332155567-55d1b12aa271?q=80&w=920&format=jpeg&fit=crop',
        'base64' => 'iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg==',
        'caption' => '<string>',
        'playback' => false,
        'ptt' => true,
        'ptv' => false,
        'sticker' => false,
        'fileName' => '<string>'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.zapsterapi.com/v1/wa/messages"

	payload := strings.NewReader("{\n  \"recipient\": \"group:123456789987654321\",\n  \"text\": \"<string>\",\n  \"instance_id\": \"ozj35qv418rpmlrb\",\n  \"auto_delete\": false,\n  \"auto_mention\": true,\n  \"view_once\": false,\n  \"reply_to\": \"3EB04E7F387C999A0DD61D\",\n  \"link_preview\": false,\n  \"mentions\": \"everyone\",\n  \"buttons\": [\n    {\n      \"label\": \"Sim, quero!\",\n      \"type\": \"reply\",\n      \"id\": \"<string>\",\n      \"phone_number\": \"+5511999999999\",\n      \"url\": \"https://exemplo.com/produto\",\n      \"copy_code\": \"PROMO2024\"\n    }\n  ],\n  \"buttons_mode\": \"auto\",\n  \"send_at\": \"2026-03-30T09:00:00-03:00\",\n  \"media\": {\n    \"url\": \"https://images.unsplash.com/photo-1721332155567-55d1b12aa271?q=80&w=920&format=jpeg&fit=crop\",\n    \"base64\": \"iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg==\",\n    \"caption\": \"<string>\",\n    \"playback\": false,\n    \"ptt\": true,\n    \"ptv\": false,\n    \"sticker\": false,\n    \"fileName\": \"<string>\"\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.zapsterapi.com/v1/wa/messages")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"recipient\": \"group:123456789987654321\",\n  \"text\": \"<string>\",\n  \"instance_id\": \"ozj35qv418rpmlrb\",\n  \"auto_delete\": false,\n  \"auto_mention\": true,\n  \"view_once\": false,\n  \"reply_to\": \"3EB04E7F387C999A0DD61D\",\n  \"link_preview\": false,\n  \"mentions\": \"everyone\",\n  \"buttons\": [\n    {\n      \"label\": \"Sim, quero!\",\n      \"type\": \"reply\",\n      \"id\": \"<string>\",\n      \"phone_number\": \"+5511999999999\",\n      \"url\": \"https://exemplo.com/produto\",\n      \"copy_code\": \"PROMO2024\"\n    }\n  ],\n  \"buttons_mode\": \"auto\",\n  \"send_at\": \"2026-03-30T09:00:00-03:00\",\n  \"media\": {\n    \"url\": \"https://images.unsplash.com/photo-1721332155567-55d1b12aa271?q=80&w=920&format=jpeg&fit=crop\",\n    \"base64\": \"iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg==\",\n    \"caption\": \"<string>\",\n    \"playback\": false,\n    \"ptt\": true,\n    \"ptv\": false,\n    \"sticker\": false,\n    \"fileName\": \"<string>\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.zapsterapi.com/v1/wa/messages")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"recipient\": \"group:123456789987654321\",\n  \"text\": \"<string>\",\n  \"instance_id\": \"ozj35qv418rpmlrb\",\n  \"auto_delete\": false,\n  \"auto_mention\": true,\n  \"view_once\": false,\n  \"reply_to\": \"3EB04E7F387C999A0DD61D\",\n  \"link_preview\": false,\n  \"mentions\": \"everyone\",\n  \"buttons\": [\n    {\n      \"label\": \"Sim, quero!\",\n      \"type\": \"reply\",\n      \"id\": \"<string>\",\n      \"phone_number\": \"+5511999999999\",\n      \"url\": \"https://exemplo.com/produto\",\n      \"copy_code\": \"PROMO2024\"\n    }\n  ],\n  \"buttons_mode\": \"auto\",\n  \"send_at\": \"2026-03-30T09:00:00-03:00\",\n  \"media\": {\n    \"url\": \"https://images.unsplash.com/photo-1721332155567-55d1b12aa271?q=80&w=920&format=jpeg&fit=crop\",\n    \"base64\": \"iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg==\",\n    \"caption\": \"<string>\",\n    \"playback\": false,\n    \"ptt\": true,\n    \"ptv\": false,\n    \"sticker\": false,\n    \"fileName\": \"<string>\"\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "message_id": "<string>"
}

{
  "message_id": "msg_k7m2nxp9q4",
  "status": "scheduled",
  "send_at": "2026-03-30T12:00:00.000Z"
}

{
  "code": "max_scheduled_messages_reached",
  "message": "You have reached the maximum of 10 scheduled messages. Cancel pending messages or upgrade your plan."
}

POST

messages

Enviando Mensagens

curl --request POST \
  --url https://api.zapsterapi.com/v1/wa/messages \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "recipient": "group:123456789987654321",
  "text": "<string>",
  "instance_id": "ozj35qv418rpmlrb",
  "auto_delete": false,
  "auto_mention": true,
  "view_once": false,
  "reply_to": "3EB04E7F387C999A0DD61D",
  "link_preview": false,
  "mentions": "everyone",
  "buttons": [
    {
      "label": "Sim, quero!",
      "type": "reply",
      "id": "<string>",
      "phone_number": "+5511999999999",
      "url": "https://exemplo.com/produto",
      "copy_code": "PROMO2024"
    }
  ],
  "buttons_mode": "auto",
  "send_at": "2026-03-30T09:00:00-03:00",
  "media": {
    "url": "https://images.unsplash.com/photo-1721332155567-55d1b12aa271?q=80&w=920&format=jpeg&fit=crop",
    "base64": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg==",
    "caption": "<string>",
    "playback": false,
    "ptt": true,
    "ptv": false,
    "sticker": false,
    "fileName": "<string>"
  }
}
'

import requests

url = "https://api.zapsterapi.com/v1/wa/messages"

payload = {
    "recipient": "group:123456789987654321",
    "text": "<string>",
    "instance_id": "ozj35qv418rpmlrb",
    "auto_delete": False,
    "auto_mention": True,
    "view_once": False,
    "reply_to": "3EB04E7F387C999A0DD61D",
    "link_preview": False,
    "mentions": "everyone",
    "buttons": [
        {
            "label": "Sim, quero!",
            "type": "reply",
            "id": "<string>",
            "phone_number": "+5511999999999",
            "url": "https://exemplo.com/produto",
            "copy_code": "PROMO2024"
        }
    ],
    "buttons_mode": "auto",
    "send_at": "2026-03-30T09:00:00-03:00",
    "media": {
        "url": "https://images.unsplash.com/photo-1721332155567-55d1b12aa271?q=80&w=920&format=jpeg&fit=crop",
        "base64": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg==",
        "caption": "<string>",
        "playback": False,
        "ptt": True,
        "ptv": False,
        "sticker": False,
        "fileName": "<string>"
    }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    recipient: 'group:123456789987654321',
    text: '<string>',
    instance_id: 'ozj35qv418rpmlrb',
    auto_delete: false,
    auto_mention: true,
    view_once: false,
    reply_to: '3EB04E7F387C999A0DD61D',
    link_preview: false,
    mentions: 'everyone',
    buttons: [
      {
        label: 'Sim, quero!',
        type: 'reply',
        id: '<string>',
        phone_number: '+5511999999999',
        url: 'https://exemplo.com/produto',
        copy_code: 'PROMO2024'
      }
    ],
    buttons_mode: 'auto',
    send_at: '2026-03-30T09:00:00-03:00',
    media: {
      url: 'https://images.unsplash.com/photo-1721332155567-55d1b12aa271?q=80&w=920&format=jpeg&fit=crop',
      base64: 'iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg==',
      caption: '<string>',
      playback: false,
      ptt: true,
      ptv: false,
      sticker: false,
      fileName: '<string>'
    }
  })
};

fetch('https://api.zapsterapi.com/v1/wa/messages', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.zapsterapi.com/v1/wa/messages",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'recipient' => 'group:123456789987654321',
    'text' => '<string>',
    'instance_id' => 'ozj35qv418rpmlrb',
    'auto_delete' => false,
    'auto_mention' => true,
    'view_once' => false,
    'reply_to' => '3EB04E7F387C999A0DD61D',
    'link_preview' => false,
    'mentions' => 'everyone',
    'buttons' => [
        [
                'label' => 'Sim, quero!',
                'type' => 'reply',
                'id' => '<string>',
                'phone_number' => '+5511999999999',
                'url' => 'https://exemplo.com/produto',
                'copy_code' => 'PROMO2024'
        ]
    ],
    'buttons_mode' => 'auto',
    'send_at' => '2026-03-30T09:00:00-03:00',
    'media' => [
        'url' => 'https://images.unsplash.com/photo-1721332155567-55d1b12aa271?q=80&w=920&format=jpeg&fit=crop',
        'base64' => 'iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg==',
        'caption' => '<string>',
        'playback' => false,
        'ptt' => true,
        'ptv' => false,
        'sticker' => false,
        'fileName' => '<string>'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.zapsterapi.com/v1/wa/messages"

	payload := strings.NewReader("{\n  \"recipient\": \"group:123456789987654321\",\n  \"text\": \"<string>\",\n  \"instance_id\": \"ozj35qv418rpmlrb\",\n  \"auto_delete\": false,\n  \"auto_mention\": true,\n  \"view_once\": false,\n  \"reply_to\": \"3EB04E7F387C999A0DD61D\",\n  \"link_preview\": false,\n  \"mentions\": \"everyone\",\n  \"buttons\": [\n    {\n      \"label\": \"Sim, quero!\",\n      \"type\": \"reply\",\n      \"id\": \"<string>\",\n      \"phone_number\": \"+5511999999999\",\n      \"url\": \"https://exemplo.com/produto\",\n      \"copy_code\": \"PROMO2024\"\n    }\n  ],\n  \"buttons_mode\": \"auto\",\n  \"send_at\": \"2026-03-30T09:00:00-03:00\",\n  \"media\": {\n    \"url\": \"https://images.unsplash.com/photo-1721332155567-55d1b12aa271?q=80&w=920&format=jpeg&fit=crop\",\n    \"base64\": \"iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg==\",\n    \"caption\": \"<string>\",\n    \"playback\": false,\n    \"ptt\": true,\n    \"ptv\": false,\n    \"sticker\": false,\n    \"fileName\": \"<string>\"\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.zapsterapi.com/v1/wa/messages")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"recipient\": \"group:123456789987654321\",\n  \"text\": \"<string>\",\n  \"instance_id\": \"ozj35qv418rpmlrb\",\n  \"auto_delete\": false,\n  \"auto_mention\": true,\n  \"view_once\": false,\n  \"reply_to\": \"3EB04E7F387C999A0DD61D\",\n  \"link_preview\": false,\n  \"mentions\": \"everyone\",\n  \"buttons\": [\n    {\n      \"label\": \"Sim, quero!\",\n      \"type\": \"reply\",\n      \"id\": \"<string>\",\n      \"phone_number\": \"+5511999999999\",\n      \"url\": \"https://exemplo.com/produto\",\n      \"copy_code\": \"PROMO2024\"\n    }\n  ],\n  \"buttons_mode\": \"auto\",\n  \"send_at\": \"2026-03-30T09:00:00-03:00\",\n  \"media\": {\n    \"url\": \"https://images.unsplash.com/photo-1721332155567-55d1b12aa271?q=80&w=920&format=jpeg&fit=crop\",\n    \"base64\": \"iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg==\",\n    \"caption\": \"<string>\",\n    \"playback\": false,\n    \"ptt\": true,\n    \"ptv\": false,\n    \"sticker\": false,\n    \"fileName\": \"<string>\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.zapsterapi.com/v1/wa/messages")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"recipient\": \"group:123456789987654321\",\n  \"text\": \"<string>\",\n  \"instance_id\": \"ozj35qv418rpmlrb\",\n  \"auto_delete\": false,\n  \"auto_mention\": true,\n  \"view_once\": false,\n  \"reply_to\": \"3EB04E7F387C999A0DD61D\",\n  \"link_preview\": false,\n  \"mentions\": \"everyone\",\n  \"buttons\": [\n    {\n      \"label\": \"Sim, quero!\",\n      \"type\": \"reply\",\n      \"id\": \"<string>\",\n      \"phone_number\": \"+5511999999999\",\n      \"url\": \"https://exemplo.com/produto\",\n      \"copy_code\": \"PROMO2024\"\n    }\n  ],\n  \"buttons_mode\": \"auto\",\n  \"send_at\": \"2026-03-30T09:00:00-03:00\",\n  \"media\": {\n    \"url\": \"https://images.unsplash.com/photo-1721332155567-55d1b12aa271?q=80&w=920&format=jpeg&fit=crop\",\n    \"base64\": \"iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg==\",\n    \"caption\": \"<string>\",\n    \"playback\": false,\n    \"ptt\": true,\n    \"ptv\": false,\n    \"sticker\": false,\n    \"fileName\": \"<string>\"\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "message_id": "<string>"
}

{
  "message_id": "msg_k7m2nxp9q4",
  "status": "scheduled",
  "send_at": "2026-03-30T12:00:00.000Z"
}

{
  "code": "max_scheduled_messages_reached",
  "message": "You have reached the maximum of 10 scheduled messages. Cancel pending messages or upgrade your plan."
}

Respondendo Mensagens

Para responder a mensagens já enviadas ou recebidas, utilize a propriedade reply_to. Isso permite que sua resposta seja vinculada diretamente à mensagem original, proporcionando um contexto claro na conversa (como mostrado na imagem abaixo).

O formato do ID muda conforme o tipo de conexão da instância:

Não oficial (QR code): o ID devolvido no envio ou recebido no webhook, como 3EB04E7F387C999A0DD61D.
Oficial (WABA): o wamid de uma mensagem da mesma conversa, como wamid.HBgNNTUxMTk5OTk5OTk5ORUCABIYFjNFQjA....

Limitação (não oficial): Atualmente, só é possível responder a mensagens que foram enviadas/recebidas nos últimos 7 dias.

Oficial (WABA): um ID que não seja um wamid válido da conversa é recusado pela Meta, e a requisição volta com erro 400 trazendo a mensagem original dela.

Agendando mensagens

Para agendar uma mensagem para envio futuro, adicione o campo send_at ao body da requisição com a data e hora no formato ISO 8601. Quando send_at está presente, a resposta muda:

Status HTTP 201 (em vez de 200)
Corpo com message_id, status: "scheduled" e send_at em UTC

O campo send_at é opcional. Quando não informado, a mensagem é enviada imediatamente como sempre.

O send_at deve ser no mínimo 1 minuto no futuro. O limite máximo depende do seu plano. Veja os limites por plano.

Para cancelar uma mensagem agendada, veja Cancelar mensagem. Para listar e rastrear todas as mensagens, veja Listar mensagens.

Autorizações

Authorization

string

header

obrigatório

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Cabeçalhos

X-Instance-ID

string

Obrigatório se instance_id não estiver presente no body.

Corpo

application/json

recipient

string

obrigatório

Número ou ID do grupo para onde será enviada a mensagem. Em caso de grupo o ID deve ser prefixado com o texto group: (Ex. group:123456789987654321). Em instâncias oficiais (WABA), este campo também aceita um BSUID (Business-Scoped User ID) para usuários com telefone oculto, ex. US.13491208655302741918. Veja o guia Enviar mensagens para BSUID.

Exemplo:

"group:123456789987654321"

text

string

obrigatório

Texto a ser enviado para o recipient (destinatário), no caso de envio de mídias esta propriedade não é obrigatória.

instance_id

string

ID da instância, obrigatório se X-Instance-ID não for informado nos cabeçalhos.

Exemplo:

"ozj35qv418rpmlrb"

auto_delete

boolean

padrão:false

Opção válida apenas quando o recipient não é um grupo. Se true então o chat/conversa será excluído após o envio da mensagem.

auto_mention

boolean

padrão:true

Opção válida apenas quando o recipient é um grupo. Se true então todo "@" seguido de um número será tratado como uma menção, então se no text ou media.caption tiver algo como "Olá @5599123451234" então tentaremos encontrar o número no grupo e fazer a menção/marcação automática.

O formato do número após o @ deve ser internacional, DDI + DDD + Número.

view_once

boolean

padrão:false

Opção válida apenas para mensagens de áudio, imagens e vídeos. Se true então só será possível visualizar a mensagem uma única vez.

reply_to

string

Para responder a uma mensagem específica, informe o ID da mensagem que deseja responder. Ao utilizar essa funcionalidade corretamente, sua resposta será vinculada à mensagem original, marcando-a de forma clara na conversa.

O formato do ID muda conforme o tipo de conexão da instância: na API não oficial é o ID devolvido no envio ou recebido no webhook (ex.: 3EB04E7F387C999A0DD61D); na API oficial (WABA) é o wamid de uma mensagem da mesma conversa (ex.: wamid.HBgNNTUxMTk5OTk5OTk5ORUCABIYFjNFQjA...).

Exemplo:

"3EB04E7F387C999A0DD61D"

link_preview

boolean

padrão:true

Quando false desabilitará a pre-visualização de links que estão presentes na mensagem.

Exemplo:

false

mentions

Há duas formas de mencionar pessoas em um grupo, você pode informar o valor everyone e todos presentes no grupo (recipient) serão mencionados, ou você pode especifica-los manualmente informando uma lista de número que deverão ser mencionados.

Opções disponíveis:

everyone

buttons

object[]

Lista de botões interativos (máximo 3). Para mais detalhes sobre tipos e modos, veja o guia de mensagens com botões.

Maximum array length: 3

Show child attributes

buttons_mode

enum<string>

padrão:auto

Modo de exibição dos botões:

auto (padrão): o sistema escolhe automaticamente com base nos tipos de botão
interactive: força o modo interativo com destaque visual

No modo auto, se pelo menos um botão for do tipo call, url ou copyable, o modo interativo é usado automaticamente.

Opções disponíveis:

auto,

interactive

template

object

Template de mensagem (apenas para instâncias WABA). Quando informado, os campos text e media são ignorados.

Show child attributes

send_at

string<date-time>

Data e hora para envio agendado no formato ISO 8601 com timezone. Quando informado, a mensagem é agendada em vez de enviada imediatamente. Deve ser no mínimo 1 minuto no futuro. O limite máximo depende do seu plano.

Exemplo:

"2026-03-30T09:00:00-03:00"

media

object

Show child attributes

Resposta

Success

message_id

string

obrigatório

ID usado para depuração interna

Instâncias

Confirmações

Webhooks

Mensagens

Para Grupos

Utilidades

Enviando Mensagens

Respondendo Mensagens

Agendando mensagens

Autorizações

Cabeçalhos

Corpo

Resposta

​Respondendo Mensagens

​Agendando mensagens

Autorizações

Cabeçalhos

Corpo

Resposta

Respondendo Mensagens

Agendando mensagens