Messages

Send a message

Protocols: Linked Device API · Meta Cloud API

Required scope: messages:write

Graph read and typing status requests require an Official API connection. Linked Device connections return a capability error; use the native Messaging API with chat context for read or typing actions there. Official API typing requests are a successful no-op. Structured order_details and order_status interactive messages are not generally available. They are sent only for teams where they are enabled, from Official API Numbers that Meta has made eligible for payments in Brazil. Other teams receive Meta-compatible capability error 131026 without a provider send.

POST

graph

{version}

{phoneNumberId}

messages

Send a message

curl --request POST \
  --url https://api.polymorfa.com/graph/whatsapp/{version}/{phoneNumberId}/messages \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "messaging_product": "whatsapp",
  "message_id": "<string>"
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({messaging_product: 'whatsapp', message_id: '<string>'})
};

fetch('https://api.polymorfa.com/graph/whatsapp/{version}/{phoneNumberId}/messages', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.polymorfa.com/graph/whatsapp/{version}/{phoneNumberId}/messages"

payload = {
    "messaging_product": "whatsapp",
    "message_id": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

package main

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

func main() {

	url := "https://api.polymorfa.com/graph/whatsapp/{version}/{phoneNumberId}/messages"

	payload := strings.NewReader("{\n  \"messaging_product\": \"whatsapp\",\n  \"message_id\": \"<string>\"\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))

}

{
  "messaging_product": "whatsapp",
  "contacts": [
    {
      "input": "<string>",
      "wa_id": "<string>",
      "user_id": "<string>"
    }
  ],
  "messages": [
    {
      "id": "<string>"
    }
  ]
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": 123,
    "fbtrace_id": "<string>",
    "error_subcode": 123,
    "error_data": "<unknown>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": 123,
    "fbtrace_id": "<string>",
    "error_subcode": 123,
    "error_data": "<unknown>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": 123,
    "fbtrace_id": "<string>",
    "error_subcode": 123,
    "error_data": "<unknown>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": 123,
    "fbtrace_id": "<string>",
    "error_subcode": 123,
    "error_data": "<unknown>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": 123,
    "fbtrace_id": "<string>",
    "error_subcode": 123,
    "error_data": "<unknown>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": 123,
    "fbtrace_id": "<string>",
    "error_subcode": 123,
    "error_data": "<unknown>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": 123,
    "fbtrace_id": "<string>",
    "error_subcode": 123,
    "error_data": "<unknown>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": 123,
    "fbtrace_id": "<string>",
    "error_subcode": 123,
    "error_data": "<unknown>"
  }
}

Structured order_details and order_status interactive messages are not available for Linked Devices or Official API Numbers. The API returns capability error 131026 before a provider send. A received order message is an order snapshot, not proof that the customer paid. Confirm settlement with your payment provider before marking an order paid.

Authorizations

Authorization

string

header

required

Polymorfa organization key (pmfa_ prefix) or project token (pmfa_pt_ prefix). Client tokens are not accepted by Graph operations.

Path Parameters

version

string

required

Specifies version for this path parameter.

Example:

"v26.0"

phoneNumberId

string

required

Identifier for the phone number.

Example:

"123456789012345"

Body

application/json

messaging_product

string

required

Messaging product associated with this Graph API object.

Example:

"whatsapp"

recipient_type

string

Category assigned to recipient.

string

Recipient phone number. When both to and recipient are present, to is used.

Example:

"15551234567"

recipient

string

Recipient business-scoped user ID, for Official API numbers only. Omit to to address this ID. Parent business-scoped user IDs are not accepted.

Example:

"US.13491208655302741918"

type

enum<string>

Type discriminator for this object.

Allowed values

Value	Meaning
`text`	Text.
`image`	Image.
`video`	Video.
`document`	Document.
`audio`	Audio.
`sticker`	Sticker.
`location`	Location.
`contacts`	Contacts.
`reaction`	Reaction.
`interactive`	Interactive.
`template`	Template.

Available options:

text,

image,

video,

document,

audio,

sticker,

location,

contacts,

reaction,

interactive,

template

text

object

Text content carried by this object.

Show child attributes

image

object

Image attached to or representing this resource.

Show child attributes

video

object

Structured video values for this graph graph send message request.

Show child attributes

document

object

Structured document values for this graph graph send message request.

Show child attributes

audio

object

Structured audio values for this graph graph send message request.

Show child attributes

sticker

object

Structured sticker values for this graph graph send message request.

Show child attributes

location

object

Structured location values for this graph graph send message request.

Show child attributes

contacts

null[]

Contact cards to send in this message.

Accepted alternatives

Item alternative	Accepted input
Item alternative 1	Any JSON value matching this alternative
Item alternative 2	`null`

reaction

object

Reaction applied to the referenced message.

Show child attributes

interactive

any | null

For Official API product and product_list sends, catalog_id must belong to a catalog linked to the Number's WABA. Product retailer IDs remain subject to Meta validation.

Accepted alternatives

Alternative	Accepted input
Alternative 1	Any JSON value matching this alternative
Alternative 2	`null`

template

any | null

Specifies template for this graph graph send message request.

Accepted alternatives

Alternative	Accepted input
Alternative 1	Any JSON value matching this alternative
Alternative 2	`null`

context

object

Structured context values for this graph graph send message request.

Show child attributes

status

string

Message delivery status to report to WhatsApp.

Example:

"read"

message_id

string

Identifier for the message.

typing_indicator

object

Shows a typing indicator and marks message_id read. Requires status: "read".

Show child attributes

Response

Message sent, or status update accepted

Option 1
Option 2

messaging_product

string

required

Messaging product associated with this Graph API object.

Example:

"whatsapp"

contacts

object[]

required

Contacts returned or affected by this operation.

Show child attributes

messages

object[]

required

Messages associated with this graph graph send message response.

Show child attributes

Send a message

curl --request POST \
  --url https://api.polymorfa.com/graph/whatsapp/{version}/{phoneNumberId}/messages \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "messaging_product": "whatsapp",
  "message_id": "<string>"
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({messaging_product: 'whatsapp', message_id: '<string>'})
};

fetch('https://api.polymorfa.com/graph/whatsapp/{version}/{phoneNumberId}/messages', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.polymorfa.com/graph/whatsapp/{version}/{phoneNumberId}/messages"

payload = {
    "messaging_product": "whatsapp",
    "message_id": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

package main

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

func main() {

	url := "https://api.polymorfa.com/graph/whatsapp/{version}/{phoneNumberId}/messages"

	payload := strings.NewReader("{\n  \"messaging_product\": \"whatsapp\",\n  \"message_id\": \"<string>\"\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))

}

{
  "messaging_product": "whatsapp",
  "contacts": [
    {
      "input": "<string>",
      "wa_id": "<string>",
      "user_id": "<string>"
    }
  ],
  "messages": [
    {
      "id": "<string>"
    }
  ]
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": 123,
    "fbtrace_id": "<string>",
    "error_subcode": 123,
    "error_data": "<unknown>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": 123,
    "fbtrace_id": "<string>",
    "error_subcode": 123,
    "error_data": "<unknown>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": 123,
    "fbtrace_id": "<string>",
    "error_subcode": 123,
    "error_data": "<unknown>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": 123,
    "fbtrace_id": "<string>",
    "error_subcode": 123,
    "error_data": "<unknown>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": 123,
    "fbtrace_id": "<string>",
    "error_subcode": 123,
    "error_data": "<unknown>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": 123,
    "fbtrace_id": "<string>",
    "error_subcode": 123,
    "error_data": "<unknown>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": 123,
    "fbtrace_id": "<string>",
    "error_subcode": 123,
    "error_data": "<unknown>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": 123,
    "fbtrace_id": "<string>",
    "error_subcode": 123,
    "error_data": "<unknown>"
  }
}

Overview

Messaging API

Platform API

Graph API

Webhook events

Send a message

Authorizations

Path Parameters

Body

Response