Messages
Post a message (API key)
Send Block Kit to any of your bot’s conversations, at any time.
POST
Append one or more bot messages to a conversation your bot owns. No event needed and no time limit, so this is the path for cron follow-ups, batch results, and anything you start yourself.
Authorization
string
required
Bearer mac_live_…Path parameters
string
required
Take it from any webhook event’s
conversation_id. It must belong to the bot your key belongs to.Body
application/json. Any Block Kit shape we accept, up to 256 KB and 10 messages.
array
One to ten messages. Each has
blocks (1 to 25) and optional mid and metadata. Shortcuts such as { "text": "…" } are expanded for you.string
Your own id for the message, matching
^[a-zA-Z0-9_.:-]{1,64}$. Send it again and the message is replaced instead of duplicated. See Updating messages.A
page block publishes a hosted Page in the same call when the conversation is an internal one. A page_preview block links a Page you already have.Response
boolean
true on success.array
One handle per message in your body, in order.
Errors
A conversation that belongs to another bot returns
404, not 403. It looks the same as an id that does not exist, on purpose, so a key cannot be used to hunt for other bots’ conversations.
