Send a message

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>"
    }
  ],
  "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>"
  }
}

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:

"v21.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

Specifies to for this graph graph send message request.

Example:

"15551234567"

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

Specifies interactive for this graph graph send message request.

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

any | null

Specifies typing indicator for this graph graph send message request.

Accepted alternatives

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

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

⌘I

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>"
    }
  ],
  "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>"
  }
}

Overview

Messaging API

Platform API

Graph API

Webhook events

Authorizations

Path Parameters

Body

Response