Messenger Overview

​

When to Use Messenger

• Marketplace sellers: Reply to buyer inquiries on your listings, automatically or from the Inbox
• Customer support: Handle Page messages alongside WhatsApp, SMS, and Email in one place
• AI agents: Let a Zavu AI Agent answer Messenger conversations 24/7

​

Basic Messenger Message

const result = await zavu.messages.send({
  to: "24025631120151183", // Messenger user ID (PSID)
  text: "Thanks for your message!",
  channel: "messenger",
});

result = zavu.messages.send(
    to="24025631120151183",  # Messenger user ID (PSID)
    text="Thanks for your message!",
    channel="messenger"
)

result = client.messages.send(
  to: "24025631120151183", # Messenger user ID (PSID)
  text: "Thanks for your message!",
  channel: "messenger"
)

result, _ := client.Messages.Send(context.TODO(), zavudev.MessageSendParams{
	To:      zavudev.String("24025631120151183"), // Messenger user ID (PSID)
	Text:    zavudev.String("Thanks for your message!"),
	Channel: zavudev.String("messenger"),
})

$result = $client->messages->send([
    'to' => '24025631120151183', // Messenger user ID (PSID)
    'text' => 'Thanks for your message!',
    'channel' => 'messenger',
]);

curl -X POST https://api.zavu.dev/v1/messages \
  -H "Authorization: Bearer $ZAVU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "24025631120151183",
    "text": "Thanks for your message!",
    "channel": "messenger"
  }'

​

Facebook Marketplace Chats

1. A buyer taps Message on your Marketplace listing
2. Zavu receives the message via your connected Facebook Page and creates a contact + conversation
3. You receive a message.inbound webhook (or your AI Agent replies automatically)
4. Reply from the Inbox, via the API, or let your agent handle it

​

User IDs vs Phone Numbers

Phone-based channels:  +14155551234
Messenger:             24025631120151183

​

24-Hour Messaging Window

• You can reply freely within 24 hours of the user’s last message
• Outside the window, Meta rejects the send and the message fails with a clear error
• There are no pre-approved templates like WhatsApp — the user must message again to reopen the window

​

Message Types

​

Delivery Status

​

Setup Requirements

1. A Facebook Page (the Page your Marketplace listings or business uses)
2. Connect the Page in your Zavu sender settings via Meta login

​

Common Errors

​

Next Steps

• Messenger Setup - Connect your Facebook Page
• Receiving Messages - Handle inbound webhooks
• AI Agents - Auto-reply to Messenger chats