messaging-rules.host-history
CC-parity 'Verlauf': list ALL outbound Hospitable host messages in an optional date range (YYYY-MM-DD, tenant timezone), attributed to their source — a Foyer messaging rule (by name), Hospitable's own automation ('Automated (Hospitable)'), or a manual host send. Manual sends (included in 'all') are excluded by default (source='all'); pass source='manual' to see them, 'scheduler' for Foyer-rule sends only, or 'hospitable_auto' for Hospitable's automation only. Also returns KPI stats (sent/delivered/failed/tomorrow_planned/week_planned) for the same range. Read-only.
Input parameters
| Field | Type | Required | Notes |
|---|---|---|---|
from | string | no | |
to | string | no | |
source | enum | no | One of: all, scheduler, hospitable_auto, manual |
Output fields
| Field | Type | Required | Notes |
|---|---|---|---|
stats | object | yes | |
stats.sent | number | yes | |
stats.delivered | number | yes | |
stats.failed | number | yes | |
stats.tomorrow_planned | number | yes | |
stats.week_planned | number | yes | |
rows | array of object | yes | |
rows.id | string | yes | |
rows.sentAt | string | yes | |
rows.body | string · nullable | yes | |
rows.externalMessageId | string · nullable | yes | |
rows.deliveryStatus | string | yes | |
rows.guestName | string · nullable | yes | |
rows.rooms | string · nullable | yes | |
rows.platform | string · nullable | yes | |
rows.ruleSource | string | yes | |
generatedAt | string | yes |
messaging-rules.preview-queue-item
Preview a scheduled (pending) messaging-queue item: renders the message with the CURRENT rule template, custom codes, hotel facts and room overrides — exactly what the sender will produce at fire time. Returns language, subject, body and a skippedReason when the item would be skipped (rule disabled, stay missing, empty template). NOT read-only: rendering a template that uses %checkin_url% or %guide_url% creates the guest check-in session if the stay has none yet.
Input parameters
| Field | Type | Required | Notes |
|---|---|---|---|
id | string | yes |
Output fields
| Field | Type | Required | Notes |
|---|---|---|---|
language | string · nullable | yes | |
subject | string · nullable | yes | |
body | string · nullable | yes | |
skippedReason | string · nullable | yes |
messaging-rules.send-queue-item-now
Send ONE pending scheduled-message queue item immediately instead of waiting for its scheduled time. Uses the exact same render+dispatch path as the cron sender. Fails with not_pending when the item is not in 'pending' state.
Input parameters
| Field | Type | Required | Notes |
|---|---|---|---|
id | string | yes |
Output fields
| Field | Type | Required | Notes |
|---|---|---|---|
status | enum | yes | One of: sent, failed |
failureReason | string | no |