DM, comment and story-reply inbox across Instagram, Facebook, WhatsApp and X.
get_conversation_messagesreadmessages.viewFull message history of a single conversation, paginated.
| conversation_id * | string | Conversation UUID. |
| cursor | string? | Opaque pagination cursor. |
| limit | integer | Defaults to 50, max 200. |
Page of messages with id, sender, body, sent_at, read_at, attachments.
"Read the last 50 messages with @customer_handle."
list_conversationsreadmessages.viewInbox view of DM conversations with filters and keyset pagination.
| instagram_account_id | string? | Scope to one IG account. |
| search | string? | Free-text search across last message + IG handle. |
| unread_only | boolean? | Only conversations with unread messages. |
| channel | string? | "dm", "comment", "story_reply" - defaults to all. |
| cursor | string? | Opaque pagination cursor from previous response. |
| limit | integer | Defaults to 50, max 100. |
Page of conversations with id, lead_id, ig_handle, last_message_preview, unread_count, channel.
"Show me unread conversations on @brand_x from this week."
search_messagesreadmessages.viewFull-text search across every DM, comment, and story reply on the workspace.
| keyword * | string | Search term. |
| instagram_account_id | string? | Scope to one IG account. |
| limit | integer | Defaults to 50, max 200. |
| offset | integer | For pagination. |
Matched messages with conversation_id, snippet, matched_at.
"Find every message that mentions 'refund' this month."
get_dm_campaign_statsreadGet per-status lead counts for one DM campaign — how many sent, delivered, replied, booked, dead. Use for campaign health check.
get_facebook_conversation_messagesreadMessages in a Facebook conversation.
get_whatsapp_conversationreadget_x_dm_messagesreadMessages in one X DM thread.
list_dm_campaign_accountsreadList Instagram accounts attached to one DM campaign — which accounts are doing the outreach.
list_dm_campaignsreadlist_facebook_conversationsreadlist_whatsapp_conversationsreadlist_whatsapp_templatesreadAvailable WhatsApp message templates.
list_x_dm_conversationsreadmark_conversation_readwriteMark a DM conversation as read.
mark_conversation_unreadwriteMark a DM conversation as unread.
mark_x_conversation_readwriteMark an X DM thread as read.
pause_dm_campaignwritePause an outbound DM campaign. Stops further outreach immediately; in-flight messages still finish.
resume_dm_campaignwriteResume a previously paused DM campaign — outreach picks up where it left off.
send_direct_messagewriteSend an Instagram DM. instagram_user_id is the SENDING account;
send_facebook_messagewriteSend a Facebook Page-to-user message.
send_whatsapp_messagewriteSend a WhatsApp text message (within 24h customer window).
send_whatsapp_template_messagewriteSend a Meta-approved WhatsApp template (starts new conversation).
send_x_dmwriteSend an X (Twitter) direct message.