Messages
Send a message
- Base URL
https://api.polymorfa.com- Required permission
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.
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.
Path parameters
versionstringrequiredSpecifies version for this path parameter.
phoneNumberIdstringrequiredIdentifier for the phone number.
Body
messaging_productstringrequiredMessaging product associated with this Graph API object.
recipient_typestringCategory assigned to recipient.
tostringRecipient phone number. When both
toandrecipientare present,tois used.recipientstringRecipient business-scoped user ID, for Official API numbers only. Omit
toto address this ID. Parent business-scoped user IDs are not accepted.typestringType discriminator for this object.
Allowed valuestextimagevideodocumentaudiostickerlocationcontactsreactioninteractivetemplatetextobjectText content carried by this object.
Show 2 child fields
imageobjectImage attached to or representing this resource.
Show 5 child fields
videoobjectStructured video values for this graph graph send message request.
Show 5 child fields
documentobjectStructured document values for this graph graph send message request.
Show 5 child fields
audioobjectStructured audio values for this graph graph send message request.
Show 5 child fields
stickerobjectStructured sticker values for this graph graph send message request.
Show 5 child fields
locationobjectStructured location values for this graph graph send message request.
Show 4 child fields
contactsarray of anymax items1000nullable itemsContact cards to send in this message.
reactionobjectReaction applied to the referenced message.
Show 2 child fields
interactiveanynullableFor 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.
templateanynullableSpecifies template for this graph graph send message request.
contextobjectStructured context values for this graph graph send message request.
Show 1 child field
statusstringMessage delivery status to report to WhatsApp.
message_idstringIdentifier for the message.
typing_indicatorobjectShows a typing indicator and marks
message_idread. Requiresstatus: "read".Show 1 child field
Responses
200Message sent, or status update accepted
One ofmessaging_productstringrequiredMessaging product associated with this Graph API object.
contactsarray of objectrequiredContacts returned or affected by this operation.
Show 3 child fields
messagesarray of objectrequiredMessages associated with this graph graph send message response.
Show 1 child field
Show 4 headers
400Bad request
401Unauthenticated
403Permission error
404Object does not exist
409Conflict
413The complete JSON request exceeds 72 MiB before parsing
429Rate limited
500Internal error
503Service unavailable
Graph API v26.0. The version is part of the URL; Graph requests take no Polymorfa-Version header.
curl -X POST "https://api.polymorfa.com/graph/whatsapp/v26.0/<phoneNumberId>/messages" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"messaging_product": "whatsapp"
}'{
"messaging_product": "whatsapp",
"contacts": [
{
"input": "string"
}
],
"messages": [
{
"id": "string"
}
]
}Create QR code
- Base URL
https://api.polymorfa.com- Required permission
messages:write
Path parameters
versionstringrequiredSpecifies version for this path parameter.
phoneNumberIdstringrequiredIdentifier for the phone number.
Body
Responses
200QR code
Show 3 headers
400Bad request
401Unauthenticated
403Permission error
404Object does not exist
429Rate limited
500Internal error
Graph API v26.0. The version is part of the URL; Graph requests take no Polymorfa-Version header.
curl -X POST "https://api.polymorfa.com/graph/whatsapp/v26.0/<phoneNumberId>/message_qrdls" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d 'null'nullList QR codes
- Base URL
https://api.polymorfa.com- Required permission
sessions:read
Path parameters
versionstringrequiredSpecifies version for this path parameter.
phoneNumberIdstringrequiredIdentifier for the phone number.
Responses
200QR codes
Show 3 headers
400Bad request
401Unauthenticated
403Permission error
404Object does not exist
429Rate limited
500Internal error
Graph API v26.0. The version is part of the URL; Graph requests take no Polymorfa-Version header.
curl "https://api.polymorfa.com/graph/whatsapp/v26.0/<phoneNumberId>/message_qrdls" \
-H "Authorization: Bearer YOUR_API_KEY"null