curl -X POST https://api.nedzo.ai/v1/conversations/messenger \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"conversationId": "9b2f6c1e-3a4d-4e5f-8a9b-0c1d2e3f4a5b",
"content": "Thanks for reaching out! We are open until 6pm today."
}'
{
"conversationId": "9b2f6c1e-3a4d-4e5f-8a9b-0c1d2e3f4a5b",
"messageId": "4d1c2b3a-5e6f-4a7b-8c9d-0e1f2a3b4c5d"
}
Conversations
Reply on Messenger
Reply in a Messenger conversation, within 24 hours of the contact’s last message.
POST
/
conversations
/
messenger
curl -X POST https://api.nedzo.ai/v1/conversations/messenger \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"conversationId": "9b2f6c1e-3a4d-4e5f-8a9b-0c1d2e3f4a5b",
"content": "Thanks for reaching out! We are open until 6pm today."
}'
{
"conversationId": "9b2f6c1e-3a4d-4e5f-8a9b-0c1d2e3f4a5b",
"messageId": "4d1c2b3a-5e6f-4a7b-8c9d-0e1f2a3b4c5d"
}
Messenger only lets a business answer a person who wrote first. So this endpoint replies in a conversation (
When
Sometimes the message goes out but Nedzo can’t save it. The answer is still
conversationId) and can’t start one. You can reply within 24 hours of the contact’s last message. After that, the send is refused with 403 until they write again.
Plans with Messenger (Pro and up) can use this endpoint. On other plans it returns 403.
Every send checks Do Not Disturb (DND) first. If the contact has DND on, the send is refused with
403 and nothing is sent. If DND can’t be checked, the send is refused too.string
Workspace UUID (required for account API keys, optional for workspace API keys)
string
required
Reply in this conversation. It must be a Messenger conversation in the workspace.
string
required
The text
When messageId is null
Sometimes the message goes out but Nedzo can’t save it. The answer is still 201, and messageId is null. The contact got the message, so don’t send it again. Then conversationId is the conversation you sent into. If that conversation had ended, the message may have gone out on a new thread that does not show in the log.
Errors
| Status | When |
|---|---|
400 | The body is not valid, or the conversation is not a Messenger conversation |
402 | The account has no plan in force, no balance or messages left, the workspace hit its spend limit, or the trial has not converted |
403 | The contact has DND on, the contact’s data is restricted, your plan does not include Messenger, or the 24-hour window has closed |
404 | The workspace or conversation was not found |
429 | Too many messages in a short time. Wait, then send again. |
502 | The message could not be sent. Check the conversation before you try again, in case it went out. |
503 | Nedzo couldn’t check the workspace’s limits. Nothing was sent. Try again in a moment. |
curl -X POST https://api.nedzo.ai/v1/conversations/messenger \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"conversationId": "9b2f6c1e-3a4d-4e5f-8a9b-0c1d2e3f4a5b",
"content": "Thanks for reaching out! We are open until 6pm today."
}'
{
"conversationId": "9b2f6c1e-3a4d-4e5f-8a9b-0c1d2e3f4a5b",
"messageId": "4d1c2b3a-5e6f-4a7b-8c9d-0e1f2a3b4c5d"
}
Was this page helpful?