Skip to main content
GET
Get a conversation

Authorizations

x-meetergo-api-user-id
string
header
required

User ID to act on behalf of. Platform API Keys only (required with an API Key unless the endpoint states otherwise). Requests authenticated with a Personal Access Token are rejected if this header names another user.

Path Parameters

id
string
required

Response

id
string
required

Conversation id.

windowOpen
boolean
required

Whether the 24-hour customer-service window is currently open. When false, only template messages are accepted.

lastMessageAt
string<date-time>
required

Timestamp of the most recent message.

lastMessageDirection
enum<string>
required
Available options:
inbound,
outbound
status
enum<string>
required

Lifecycle status. done conversations are archived.

Available options:
open,
done
createdAt
string<date-time>
required

When the conversation was created.

phone
string | null

Contact phone number in E.164 format. Null when the contact has adopted a WhatsApp username and withheld their phone; use userId.

userId
string | null

Business-Scoped User ID (BSUID), the stable identity used to send when no phone is known.

username
string | null

WhatsApp @username the contact has adopted, if any.

contactName
string

Contact name from the WhatsApp profile.

contactId
string

Linked meetergo CRM contact id, if any.

windowExpiresAt
string<date-time>

When the 24h window expires (ISO 8601). Absent if no window.

lastMessagePreview
string

Preview text of the last message.

labels
string[]

Conversation labels.