Inbox

Send a reply

Sends your reply to the person at once on the conversation’s reply_channel: on LinkedIn from the conversation’s LinkedIn account, or by email in the same thread from the inbox it went through. Returns the conversation with the reply filed; on a campaign conversation it also clears needs_reply and suggested_reply. Send an Idempotency-Key header to make a retry safe.

POST
/conversations/{id}/messages

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

idempotency-keystring

Any unique string of 1 to 255 characters, such as a UUID, that makes a retry safe: a repeat with the same key and input does nothing again and returns the current state, while the same key with another input, or before the first request finished, is refused. Keys last 24 hours per workspace.

Path Parameters

idstringrequired

The conversation's id, from List conversations.

Body

application/json
bodystringrequired

The reply text, 1 to 8000 characters once surrounding whitespace is trimmed.

Response

application/json

Success

idstringrequired
scopeenum<string>required

campaigns: a person a campaign reached. other: a LinkedIn or email conversation outside campaigns, from an account whose all_messages is on.

Available options: campaigns, other

personobjectrequired

The other person in the conversation.

campaignobject | nullrequired

The campaign that reached the person; null in scope other.

senderstringrequired

Who answers on your side: the LinkedIn account's name or the email inbox's address, otherwise the workspace name.

reply_channelenum<string>required

Where a reply goes out: linkedin or email, the channel the person last wrote on.

Available options: linkedin, email

intentenum<string> | nullrequired

What the person's latest reply means, as Bavlio read it: interested (open to talking or asking how to proceed), meeting_booked (says a meeting is booked), question (asks something before deciding), referral (points to someone else), not_now (not a priority now, maybe later) or not_interested (a clear no). Null until a reply was read, and always in scope other.

Available options: interested, meeting_booked, question, referral, not_now, not_interested

needs_replybooleanrequired

True while the person's latest reply waits for an answer. Replies read as meeting_booked or not_interested need none; always false in scope other.

unread_countintegerrequired

How many of the person's messages are unread; marking the conversation read resets it.

suggested_replystring | nullrequired

A reply Bavlio drafted to the person's latest message, for you to edit and send; null when there is none, and always in scope other.

meetingobject | nullrequired

The meeting booked with the person; null when none, and always in scope other.

last_message_authorenum<string>required

Who wrote the latest message: lead, campaign or you.

Available options: lead, campaign, you

last_message_previewstringrequired

The first 160 characters of the latest message.

last_message_atstringrequired

When the latest message was sent, ISO 8601.

messagesobject[]required

The whole transcript, oldest message first.