messages.anrufe
read-only
Messages: anrufe. Read-only query. See the input schema for argument details.
Input parameters
| Field | Type | Required | Notes |
|---|---|---|---|
stayId | string | yes |
Output fields
Returns array of object. Fields of each element:
| Field | Type | Required | Notes |
|---|---|---|---|
id | string | yes | |
startedAt | string | yes | |
durationSec | number · nullable | yes | |
summary | string · nullable | yes | |
outcome | string · nullable | yes | |
quelle | enum | yes | One of: bot, anlage |
richtung | number · nullable | yes | |
nummer | string · nullable | yes | |
rueckrufStatus | string · nullable | yes | |
waNummer | string · nullable | yes |
messages.faden
read-only
Messages: faden. Read-only query. See the input schema for argument details.
Input parameters
| Field | Type | Required | Notes |
|---|---|---|---|
conversationId | string | yes |
Output fields
| Field | Type | Required | Notes |
|---|---|---|---|
kopf | object | yes | |
kopf.conversationId | string | yes | |
kopf.stayId | string · nullable | yes | |
kopf.exConversationId | string · nullable | yes | |
kopf.platform | string · nullable | yes | |
kopf.kanal | string · nullable | yes | |
kopf.name | string · nullable | yes | |
kopf.telefon | string · nullable | yes | |
kopf.lastMessageAt | string · nullable | yes | |
nachrichten | array of object | yes | |
nachrichten.id | string | yes | |
nachrichten.tenantId | string | yes | |
nachrichten.conversationId | string | yes | |
nachrichten.channel | enum | yes | One of: whatsapp, email, hospitable, voice, channex, beds24 |
nachrichten.direction | enum | yes | One of: inbound, outbound |
nachrichten.sender | string · nullable | yes | |
nachrichten.body | string · nullable | yes | |
nachrichten.languageDetected | string · nullable | yes | |
nachrichten.aiLayer | enum · nullable | yes | One of: rule, llm, manual, escalated, auto_received |
nachrichten.aiConfidence | string · nullable | yes | Decimal as string — numeric column, not an IEEE-754 double |
nachrichten.aiReplyToMessageId | string · nullable | yes | |
nachrichten.attachmentUrl | string · nullable | yes | |
nachrichten.attachmentKind | enum · nullable | yes | One of: audio, image, file |
nachrichten.externalMessageId | string · nullable | yes | |
nachrichten.sentReferenceId | string · nullable | yes | |
nachrichten.externalThreadRefs | array of string · nullable | yes | |
nachrichten.subject | string · nullable | yes | |
nachrichten.bodyHtml | string · nullable | yes | |
nachrichten.state | enum | yes | One of: draft, sent |
nachrichten.sentAt | string | yes | |
nachrichten.providerName | string · nullable | yes | |
nachrichten.providerSource | string · nullable | yes | |
nachrichten.deliveryStatus | enum | yes | One of: queued, sent, beobachtet, provider_acked, delivered, read, failed, sync_unknown |
nachrichten.lastReconciledAt | string · nullable | yes | |
nachrichten.invoiceRequested | boolean | yes | |
nachrichten.attachments | array of object | yes |
messages.fadenAntworten
writes
Messages: faden antworten. Mutation — changes data. See the input schema for argument details.
Input parameters
| Field | Type | Required | Notes |
|---|---|---|---|
conversationId | string | yes | |
body | string | yes |
Output fields
| Field | Type | Required | Notes |
|---|---|---|---|
messageId | string | yes | |
externalMessageId | string · nullable | yes |
messages.fadenVorschlag
read-only
Messages: faden vorschlag. Read-only query. See the input schema for argument details.
Input parameters
| Field | Type | Required | Notes |
|---|---|---|---|
conversationId | string | yes |
Output fields
| Field | Type | Required | Notes |
|---|---|---|---|
stayId | string · nullable | yes | |
guestName | string · nullable | yes | |
room | string · nullable | yes | |
checkIn | string · nullable | yes | |
grund | string · nullable | yes |
messages.fadenZuordnen
writes
Messages: faden zuordnen. Mutation — changes data. See the input schema for argument details.
Input parameters
| Field | Type | Required | Notes |
|---|---|---|---|
conversationId | string | yes | |
stayId | string · nullable | yes |
Output fields
| Field | Type | Required | Notes |
|---|---|---|---|
ok | literal | yes | One of: true |
messages.listByStay
read-only
List all messages for a single stay's conversation thread.
Input parameters
| Field | Type | Required | Notes |
|---|---|---|---|
stayId | string | yes |
Output fields
Returns array of object. Fields of each element:
| Field | Type | Required | Notes |
|---|---|---|---|
id | string | yes | |
tenantId | string | yes | |
conversationId | string | yes | |
channel | enum | yes | One of: whatsapp, email, hospitable, voice, channex, beds24 |
direction | enum | yes | One of: inbound, outbound |
sender | string · nullable | yes | |
body | string · nullable | yes | |
languageDetected | string · nullable | yes | |
aiLayer | enum · nullable | yes | One of: rule, llm, manual, escalated, auto_received |
aiConfidence | string · nullable | yes | Decimal as string — numeric column, not an IEEE-754 double |
aiReplyToMessageId | string · nullable | yes | |
attachmentUrl | string · nullable | yes | |
attachmentKind | enum · nullable | yes | One of: audio, image, file |
externalMessageId | string · nullable | yes | |
sentReferenceId | string · nullable | yes | |
externalThreadRefs | array of string · nullable | yes | |
subject | string · nullable | yes | |
bodyHtml | string · nullable | yes | |
state | enum | yes | One of: draft, sent |
sentAt | string | yes | |
providerName | string · nullable | yes | |
providerSource | string · nullable | yes | |
deliveryStatus | enum | yes | One of: queued, sent, beobachtet, provider_acked, delivered, read, failed, sync_unknown |
lastReconciledAt | string · nullable | yes | |
invoiceRequested | boolean | yes | |
attachments | array of object | yes | |
attachments.id | string | yes | |
attachments.messageId | string | yes | |
attachments.kind | literal | yes | One of: photo |
attachments.url | string | yes | |
attachments.mimeType | string · nullable | yes | |
attachments.sizeBytes | integer · nullable | yes |
messages.listConversations
read-only
List guest message conversations (inbox threads).
Input parameters
| Field | Type | Required | Notes |
|---|---|---|---|
filter | enum | no | One of: all, unanswered, alarme — Default: "all" |
kanal | array of enum | no | |
aufenthalt | enum | no | One of: anreisend, im_haus, abgereist |
anreiseVon | string | no | |
anreiseBis | string | no | |
sprache | array of string | no | |
status | array of enum | no | |
search | string | no | |
limit | integer | no | Default: 25 |
cursor | string | no |
Output fields
| Field | Type | Required | Notes |
|---|---|---|---|
items | array of object | yes | |
items.conversationId | string | yes | |
items.stayId | string · nullable | yes | |
items.exConversationId | string · nullable | yes | |
items.externalRef | string · nullable | yes | |
items.guestName | string | yes | |
items.channel | enum | yes | One of: whatsapp, email, hospitable, voice, channex, beds24 |
items.lastBody | string · nullable | yes | |
items.lastAt | string | yes | |
items.lastDirection | enum | yes | One of: inbound, outbound |
items.needsReply | boolean | yes | |
items.room | string · nullable | yes | |
items.stayStatus | string · nullable | yes | |
items.platform | string · nullable | yes | |
items.isInquiry | boolean | yes | |
items.hatAnruf | boolean | yes | |
items.verlangtRueckruf | boolean | yes | |
nextCursor | string · nullable | yes |
messages.listUnconfirmed
read-only
Messages: list unconfirmed. Read-only query. See the input schema for argument details.
Input parameters
| Field | Type | Required | Notes |
|---|---|---|---|
limit | integer | no | Default: 100 |
Output fields
| Field | Type | Required | Notes |
|---|---|---|---|
items | array of object | yes | |
items.messageId | string | yes | |
items.conversationId | string | yes | |
items.channel | enum | yes | One of: whatsapp, email, hospitable, voice, channex, beds24 |
items.providerName | string · nullable | yes | |
items.deliveryStatus | enum | yes | One of: queued, sent, beobachtet, provider_acked, delivered, read, failed, sync_unknown |
items.subject | string · nullable | yes | |
items.body | string · nullable | yes | |
items.externalMessageId | string · nullable | yes | |
items.sentAt | string | yes | |
items.lastReconciledAt | string · nullable | yes | |
count | integer | yes | |
notCheckableCount | integer | yes | |
notCheckableProviders | array of string | yes |
messages.markDelivered
writes
Messages: mark delivered. Mutation — changes data. See the input schema for argument details.
Input parameters
| Field | Type | Required | Notes |
|---|---|---|---|
messageId | string | yes |
Output fields
| Field | Type | Required | Notes |
|---|---|---|---|
ok | literal | yes | One of: true |
messages.resyncReservation
writes
Re-pull a reservation's message history from Hospitable to heal a sync gap. Idempotent, read-mostly.
Input parameters
| Field | Type | Required | Notes |
|---|---|---|---|
reservationUuid | string | yes |
Output fields
One of 2 shapes, depending on the outcome:
Shape 1
| Field | Type | Required | Notes |
|---|---|---|---|
ok | literal | yes | One of: true |
messagesSeen | integer | yes | |
messagesInserted | integer | yes | |
skipped | integer | yes |
Shape 2
| Field | Type | Required | Notes |
|---|---|---|---|
ok | literal | yes | One of: false |
reason | enum | yes | One of: no_api_key, auth_failed, api_error, internal |
message | string | yes |
messages.send
writesconfirm
Send a message to the guest on a reservation's conversation thread. This contacts the guest for real over the booking channel (Airbnb/Booking/email). Requires confirmation.
Input parameters
| Field | Type | Required | Notes |
|---|---|---|---|
stayId | string | yes | |
body | string | yes |
Output fields
| Field | Type | Required | Notes |
|---|---|---|---|
messageId | string | yes |