getricky 0.1.9 → 0.1.11

package/dist/cjs/generated/types.gen.d.ts

@@ -1,7 +1,7 @@
 export type ClientOptions = {
     baseUrl: 'https://getricky.ai/api/v1' | (string & {});
 };
-export type Webhooks = WebhookMessageReceivedWebhookRequest | WebhookMessageSentWebhookRequest | WebhookMessageDeliveredWebhookRequest | WebhookMessageReadWebhookRequest | WebhookMessageFailedWebhookRequest | WebhookConversationOpenedWebhookRequest | WebhookConversationClosedWebhookRequest | WebhookConversationAssignmentChangedWebhookRequest | WebhookContactCreatedWebhookRequest | WebhookContactUpdatedWebhookRequest | WebhookWebhookTestWebhookRequest;
+export type Webhooks = WebhookMessageReceivedWebhookRequest | WebhookMessageSentWebhookRequest | WebhookMessageDeliveredWebhookRequest | WebhookMessageReadWebhookRequest | WebhookMessageFailedWebhookRequest | WebhookConversationOpenedWebhookRequest | WebhookConversationClosedWebhookRequest | WebhookConversationAssignmentChangedWebhookRequest | WebhookConversationAgentChangedWebhookRequest | WebhookConversationHandoffRequestedWebhookRequest | WebhookConversationHandoffResolvedWebhookRequest | WebhookContactCreatedWebhookRequest | WebhookContactUpdatedWebhookRequest | WebhookContactTagsChangedWebhookRequest | WebhookBroadcastCompletedWebhookRequest | WebhookBroadcastFailedWebhookRequest | WebhookTemplateStatusChangedWebhookRequest | WebhookWorkflowExecutionFailedWebhookRequest | WebhookKnowledgeFileReadyWebhookRequest | WebhookWebhookTestWebhookRequest;
 /**
  * Every non-2xx response.
  */
@@ -734,6 +734,216 @@ export type BroadcastRecipient = {
      */
     status_updated_at: string | null;
 };
+/**
+ * How many numbers an audience resolves to now.
+ */
+export type BroadcastAudiencePreview = {
+    /**
+     * Numbers a broadcast to this audience would go to now, at most 5,000.
+     */
+    recipients: number;
+    /**
+     * Contacts or numbers left out because they have no valid WhatsApp number.
+     */
+    skipped: number;
+};
+/**
+ * A branch or place the agents can send as a WhatsApp location.
+ */
+export type KnowledgeLocation = {
+    /**
+     * Location ID.
+     */
+    id: string;
+    /**
+     * Name customers know it by.
+     */
+    name: string;
+    /**
+     * Full address as customers read it.
+     */
+    address: string;
+    /**
+     * Latitude of the map pin.
+     */
+    latitude: number;
+    /**
+     * Longitude of the map pin.
+     */
+    longitude: number;
+    /**
+     * Street.
+     */
+    street: string | null;
+    /**
+     * City.
+     */
+    city: string | null;
+    /**
+     * State, province or region.
+     */
+    state: string | null;
+    /**
+     * Postal code.
+     */
+    postal_code: string | null;
+    /**
+     * Country.
+     */
+    country: string | null;
+    /**
+     * Country code, ISO 3166-1 alpha-2.
+     */
+    country_code: string | null;
+    /**
+     * Phone in E.164.
+     */
+    phone: string | null;
+    /**
+     * Email.
+     */
+    email: string | null;
+    /**
+     * Opening hours, as free text.
+     */
+    hours: string | null;
+};
+/**
+ * A contact card in the knowledge directory, which agents can send to customers.
+ */
+export type KnowledgeContact = {
+    /**
+     * Knowledge contact ID.
+     */
+    id: string;
+    /**
+     * Name shown on the contact card.
+     */
+    display_name: string;
+    /**
+     * First name.
+     */
+    first_name: string | null;
+    /**
+     * Last name.
+     */
+    last_name: string | null;
+    /**
+     * Name prefix, such as `Dr.`.
+     */
+    prefix: string | null;
+    /**
+     * Name suffix.
+     */
+    suffix: string | null;
+    /**
+     * Company.
+     */
+    company: string | null;
+    /**
+     * Department.
+     */
+    department: string | null;
+    /**
+     * Job title.
+     */
+    job_title: string | null;
+    /**
+     * When the agents should share it.
+     */
+    description: string | null;
+    /**
+     * Phone in E.164.
+     */
+    phone: string | null;
+    /**
+     * `CELL`, `WORK` or `HOME`.
+     */
+    phone_type: string | null;
+    /**
+     * Email.
+     */
+    email: string | null;
+    /**
+     * `WORK` or `PERSONAL`.
+     */
+    email_type: string | null;
+};
+/**
+ * A document or image the agents can consult or send.
+ */
+export type KnowledgeFile = {
+    /**
+     * File ID.
+     */
+    id: string;
+    /**
+     * Title the agents see.
+     */
+    title: string;
+    /**
+     * When the agents should use it; may be empty.
+     */
+    description: string;
+    /**
+     * Original file name.
+     */
+    filename: string;
+    /**
+     * File type.
+     */
+    mime_type: 'application/pdf' | 'application/vnd.openxmlformats-officedocument.wordprocessingml.document' | 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet' | 'image/jpeg' | 'image/png';
+    /**
+     * Size in bytes.
+     */
+    size_bytes: number;
+    /**
+     * `uploading` until `POST /knowledge/files/{file_id}/complete` reads it; then `ready`.
+     */
+    status: 'uploading' | 'ready' | 'failed';
+    /**
+     * Agents may read it to answer.
+     */
+    consult_enabled: boolean;
+    /**
+     * Agents may send the file itself to customers.
+     */
+    send_enabled: boolean;
+    /**
+     * Pages of a PDF; null otherwise.
+     */
+    page_count: number | null;
+    /**
+     * Start of the text Ricky read from it.
+     */
+    preview: string | null;
+    /**
+     * Why Ricky could not read useful content; null when it could.
+     */
+    extraction_error: string | null;
+    /**
+     * Signed download URL, valid for five minutes. Only `GET /knowledge/files/{file_id}` of a `ready` file carries it; null elsewhere.
+     */
+    download_url: string | null;
+    /**
+     * When the upload began.
+     */
+    created_at: string;
+    /**
+     * Last change.
+     */
+    updated_at: string;
+};
+/**
+ * A file waiting for its bytes, and where to put them.
+ */
+export type KnowledgeFileUpload = {
+    file: KnowledgeFile;
+    /**
+     * Signed URL valid for two hours. `PUT` the file bytes to it with `Content-Type` set to `mime_type`, then call `POST /knowledge/files/{file_id}/complete`.
+     */
+    upload_url: string;
+};
 /**
  * A webhook subscription.
  */
@@ -746,7 +956,7 @@ export type Webhook = {
      * HTTPS endpoint Ricky posts to.
      */
     url: string;
-    event_types: Array<'message.received' | 'message.sent' | 'message.delivered' | 'message.read' | 'message.failed' | 'conversation.opened' | 'conversation.closed' | 'conversation.assignment_changed' | 'contact.created' | 'contact.updated'>;
+    event_types: Array<'message.received' | 'message.sent' | 'message.delivered' | 'message.read' | 'message.failed' | 'conversation.opened' | 'conversation.closed' | 'conversation.assignment_changed' | 'conversation.agent_changed' | 'conversation.handoff_requested' | 'conversation.handoff_resolved' | 'contact.created' | 'contact.updated' | 'contact.tags_changed' | 'broadcast.completed' | 'broadcast.failed' | 'template.status_changed' | 'workflow.execution_failed' | 'knowledge_file.ready'>;
     status: 'active' | 'disabled';
     /**
      * When it was created.
@@ -769,7 +979,7 @@ export type CreatedWebhook = {
      * HTTPS endpoint Ricky posts to.
      */
     url: string;
-    event_types: Array<'message.received' | 'message.sent' | 'message.delivered' | 'message.read' | 'message.failed' | 'conversation.opened' | 'conversation.closed' | 'conversation.assignment_changed' | 'contact.created' | 'contact.updated'>;
+    event_types: Array<'message.received' | 'message.sent' | 'message.delivered' | 'message.read' | 'message.failed' | 'conversation.opened' | 'conversation.closed' | 'conversation.assignment_changed' | 'conversation.agent_changed' | 'conversation.handoff_requested' | 'conversation.handoff_resolved' | 'contact.created' | 'contact.updated' | 'contact.tags_changed' | 'broadcast.completed' | 'broadcast.failed' | 'template.status_changed' | 'workflow.execution_failed' | 'knowledge_file.ready'>;
     status: 'active' | 'disabled';
     /**
      * When it was created.
@@ -792,7 +1002,7 @@ export type WebhookDelivery = {
      * Delivery ID; equals the event `id` and `X-Ricky-Delivery-Id`.
      */
     id: string;
-    event_type: 'message.received' | 'message.sent' | 'message.delivered' | 'message.read' | 'message.failed' | 'conversation.opened' | 'conversation.closed' | 'conversation.assignment_changed' | 'contact.created' | 'contact.updated';
+    event_type: 'message.received' | 'message.sent' | 'message.delivered' | 'message.read' | 'message.failed' | 'conversation.opened' | 'conversation.closed' | 'conversation.assignment_changed' | 'conversation.agent_changed' | 'conversation.handoff_requested' | 'conversation.handoff_resolved' | 'contact.created' | 'contact.updated' | 'contact.tags_changed' | 'broadcast.completed' | 'broadcast.failed' | 'template.status_changed' | 'workflow.execution_failed' | 'knowledge_file.ready';
     status: 'pending' | 'processing' | 'delivered' | 'failed';
     /**
      * Delivery attempts so far; Ricky makes at most ten.
@@ -827,7 +1037,7 @@ export type WebhookEvent = {
      * Delivery ID. Deduplicate by it.
      */
     id: string;
-    type: 'message.received' | 'message.sent' | 'message.delivered' | 'message.read' | 'message.failed' | 'conversation.opened' | 'conversation.closed' | 'conversation.assignment_changed' | 'contact.created' | 'contact.updated' | 'webhook.test';
+    type: 'message.received' | 'message.sent' | 'message.delivered' | 'message.read' | 'message.failed' | 'conversation.opened' | 'conversation.closed' | 'conversation.assignment_changed' | 'conversation.agent_changed' | 'conversation.handoff_requested' | 'conversation.handoff_resolved' | 'contact.created' | 'contact.updated' | 'contact.tags_changed' | 'broadcast.completed' | 'broadcast.failed' | 'template.status_changed' | 'workflow.execution_failed' | 'knowledge_file.ready' | 'webhook.test';
     /**
      * When it happened.
      */
@@ -849,6 +1059,26 @@ export type WebhookEvent = {
          * Contact, for `contact.*` events.
          */
         contact_id?: string;
+        /**
+         * Broadcast, for `broadcast.*` events.
+         */
+        broadcast_id?: string;
+        /**
+         * Template ID at Meta, for `template.status_changed`.
+         */
+        template_id?: string;
+        /**
+         * Workflow, for `workflow.execution_failed`.
+         */
+        workflow_id?: string;
+        /**
+         * Execution, for `workflow.execution_failed`.
+         */
+        workflow_execution_id?: string;
+        /**
+         * Knowledge file, for `knowledge_file.ready`.
+         */
+        knowledge_file_id?: string;
         /**
          * Webhook, for `webhook.test`.
          */
@@ -967,203 +1197,6 @@ export type ConversationAssignmentResult = {
      */
     status: 'assigned' | 'not_found' | 'failed';
 };
-/**
- * A branch or place the agents can send as a WhatsApp location.
- */
-export type KnowledgeLocation = {
-    /**
-     * Location ID.
-     */
-    id: string;
-    /**
-     * Name customers know it by.
-     */
-    name: string;
-    /**
-     * Full address as customers read it.
-     */
-    address: string;
-    /**
-     * Latitude of the map pin.
-     */
-    latitude: number;
-    /**
-     * Longitude of the map pin.
-     */
-    longitude: number;
-    /**
-     * Street.
-     */
-    street: string | null;
-    /**
-     * City.
-     */
-    city: string | null;
-    /**
-     * State, province or region.
-     */
-    state: string | null;
-    /**
-     * Postal code.
-     */
-    postal_code: string | null;
-    /**
-     * Country.
-     */
-    country: string | null;
-    /**
-     * Country code, ISO 3166-1 alpha-2.
-     */
-    country_code: string | null;
-    /**
-     * Phone in E.164.
-     */
-    phone: string | null;
-    /**
-     * Email.
-     */
-    email: string | null;
-    /**
-     * Opening hours, as free text.
-     */
-    hours: string | null;
-};
-/**
- * A contact card in the knowledge directory, which agents can send to customers.
- */
-export type KnowledgeContact = {
-    /**
-     * Knowledge contact ID.
-     */
-    id: string;
-    /**
-     * Name shown on the contact card.
-     */
-    display_name: string;
-    /**
-     * First name.
-     */
-    first_name: string | null;
-    /**
-     * Last name.
-     */
-    last_name: string | null;
-    /**
-     * Name prefix, such as `Dr.`.
-     */
-    prefix: string | null;
-    /**
-     * Name suffix.
-     */
-    suffix: string | null;
-    /**
-     * Company.
-     */
-    company: string | null;
-    /**
-     * Department.
-     */
-    department: string | null;
-    /**
-     * Job title.
-     */
-    job_title: string | null;
-    /**
-     * When the agents should share it.
-     */
-    description: string | null;
-    /**
-     * Phone in E.164.
-     */
-    phone: string | null;
-    /**
-     * `CELL`, `WORK` or `HOME`.
-     */
-    phone_type: string | null;
-    /**
-     * Email.
-     */
-    email: string | null;
-    /**
-     * `WORK` or `PERSONAL`.
-     */
-    email_type: string | null;
-};
-/**
- * A document or image the agents can consult or send.
- */
-export type KnowledgeFile = {
-    /**
-     * File ID.
-     */
-    id: string;
-    /**
-     * Title the agents see.
-     */
-    title: string;
-    /**
-     * When the agents should use it; may be empty.
-     */
-    description: string;
-    /**
-     * Original file name.
-     */
-    filename: string;
-    /**
-     * File type.
-     */
-    mime_type: 'application/pdf' | 'application/vnd.openxmlformats-officedocument.wordprocessingml.document' | 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet' | 'image/jpeg' | 'image/png';
-    /**
-     * Size in bytes.
-     */
-    size_bytes: number;
-    /**
-     * `uploading` until `POST /knowledge/files/{file_id}/complete` reads it; then `ready`.
-     */
-    status: 'uploading' | 'ready' | 'failed';
-    /**
-     * Agents may read it to answer.
-     */
-    consult_enabled: boolean;
-    /**
-     * Agents may send the file itself to customers.
-     */
-    send_enabled: boolean;
-    /**
-     * Pages of a PDF; null otherwise.
-     */
-    page_count: number | null;
-    /**
-     * Start of the text Ricky read from it.
-     */
-    preview: string | null;
-    /**
-     * Why Ricky could not read useful content; null when it could.
-     */
-    extraction_error: string | null;
-    /**
-     * Signed download URL, valid for five minutes. Only `GET /knowledge/files/{file_id}` of a `ready` file carries it; null elsewhere.
-     */
-    download_url: string | null;
-    /**
-     * When the upload began.
-     */
-    created_at: string;
-    /**
-     * Last change.
-     */
-    updated_at: string;
-};
-/**
- * A file waiting for its bytes, and where to put them.
- */
-export type KnowledgeFileUpload = {
-    file: KnowledgeFile;
-    /**
-     * Signed URL valid for two hours. `PUT` the file bytes to it with `Content-Type` set to `mime_type`, then call `POST /knowledge/files/{file_id}/complete`.
-     */
-    upload_url: string;
-};
 /**
  * The days a report covers, in America/Panama time, and the period it is compared with.
  */
@@ -2210,145 +2243,180 @@ export type ResolutionsReport = {
     /**
      * The period by who held the conversation when it closed, most closes first.
      */
-    by_assignee: Array<{
-        /**
-         * Who held the conversation when it closed.
-         */
-        type: 'human' | 'ai' | 'unassigned';
-        /**
-         * Name; null when it has none and for `unassigned`. Equal names are one row.
-         */
-        name: string | null;
-        /**
-         * Closes in the period.
-         */
-        closed: number;
-        /**
-         * Median time from opening to close, in seconds.
-         */
-        median_resolution_seconds: number | null;
-    }>;
-    /**
-     * Closes of the period by how long the conversation was open.
-     */
-    distribution: Array<{
-        bucket: 'under_1h' | '1h_4h' | '4h_24h' | '1d_3d' | 'over_3d';
-        /**
-         * Closes in the period that took that long.
-         */
-        closed: number;
-    }>;
-    /**
-     * When Ricky computed the report.
-     */
-    generated_at: string;
-};
-/**
- * The result of checking a template draft without submitting it.
- */
-export type TemplateValidation = {
-    /**
-     * Whether `POST /templates` would submit this draft to Meta.
-     */
-    valid: boolean;
-    /**
-     * Every problem found; empty when the draft is valid.
-     */
-    errors: Array<{
-        /**
-         * The request field the problem is in.
-         */
-        param: string;
-        /**
-         * What to change.
-         */
-        message: string;
-    }>;
-    /**
-     * The components Ricky would submit, in the WhatsApp Cloud API format; null when the draft is invalid.
-     */
-    components: Array<{
-        [key: string]: unknown;
-    }> | null;
-};
-/**
- * A template Meta deleted.
- */
-export type DeletedTemplate = {
-    /**
-     * Template ID at Meta.
-     */
-    id: string;
-    deleted: true;
-};
-/**
- * A WhatsApp number, with its status, quality and messaging limit at Meta.
- */
-export type WhatsAppNumber = {
-    /**
-     * Channel ID.
-     */
-    id: string;
-    /**
-     * Name shown in Ricky.
-     */
-    name: string;
-    /**
-     * Phone in E.164.
-     */
-    phone_number: string | null;
-    /**
-     * Business name Meta approved for the number.
-     */
-    verified_name: string | null;
-    /**
-     * Phone number ID at Meta.
-     */
-    phone_number_id: string | null;
+    by_assignee: Array<{
+        /**
+         * Who held the conversation when it closed.
+         */
+        type: 'human' | 'ai' | 'unassigned';
+        /**
+         * Name; null when it has none and for `unassigned`. Equal names are one row.
+         */
+        name: string | null;
+        /**
+         * Closes in the period.
+         */
+        closed: number;
+        /**
+         * Median time from opening to close, in seconds.
+         */
+        median_resolution_seconds: number | null;
+    }>;
     /**
-     * WhatsApp Business Account that owns the number.
+     * Closes of the period by how long the conversation was open.
      */
-    whatsapp_business_account_id: string | null;
+    distribution: Array<{
+        bucket: 'under_1h' | '1h_4h' | '4h_24h' | '1d_3d' | 'over_3d';
+        /**
+         * Closes in the period that took that long.
+         */
+        closed: number;
+    }>;
     /**
-     * `coexistence` when the number also stays on the WhatsApp Business app; `dedicated` otherwise.
+     * When Ricky computed the report.
      */
-    connection_mode: 'dedicated' | 'coexistence' | null;
+    generated_at: string;
+};
+/**
+ * The Odoo appointments a reminder workflow would message on a coming day.
+ */
+export type ReminderPreview = {
     /**
-     * Status of the number at Meta, as Meta reports it, for example `CONNECTED`.
+     * Day the workflow sends these reminders, in its time zone.
      */
-    status: string | null;
+    date: string;
     /**
-     * When the number was disconnected from Ricky; null while connected.
+     * IANA time zone of the workflow.
      */
-    disconnected_at: string | null;
+    timezone: string;
     /**
-     * Whether Meta lets the number send: `available`, `limited` or `blocked`.
+     * When Ricky read the appointments from Odoo.
      */
-    messaging_health: 'available' | 'limited' | 'blocked';
+    checked_at: string;
     /**
-     * Quality rating at Meta: `green`, `yellow`, `red`, `not_yet_determined` or `unknown`.
+     * Every appointment state the Odoo installation has.
      */
-    quality_rating: string | null;
+    appointment_states: Array<{
+        /**
+         * State as Odoo stores it.
+         */
+        value: string;
+        /**
+         * State as Odoo shows it.
+         */
+        label: string;
+    }>;
     /**
-     * Messaging limit tier at Meta, for example `TIER_1K` or `TIER_UNLIMITED`; `UNKNOWN` when Meta has not reported it.
+     * Each appointment of that day in Odoo, in start order.
      */
-    messaging_limit: string | null;
+    reminders: Array<{
+        /**
+         * Appointment ID in Odoo.
+         */
+        appointment_id: string;
+        /**
+         * Appointment state in Odoo.
+         */
+        appointment_state: string;
+        /**
+         * Customer first name in Odoo.
+         */
+        customer_first_name: string | null;
+        /**
+         * Phone in Odoo.
+         */
+        phone: string | null;
+        /**
+         * Branch in Odoo.
+         */
+        branch_name: string | null;
+        /**
+         * When the appointment starts.
+         */
+        starts_at: string;
+        /**
+         * Why it is not sent: its Odoo state is not one the workflow reminds (`state`), or it has no customer name (`name`), branch (`branch`) or valid phone (`phone`); null when it is sent.
+         */
+        excluded_because: 'state' | 'name' | 'branch' | 'phone' | null;
+        /**
+         * The message the template would send, with this appointment’s values.
+         */
+        message: string;
+        /**
+         * The send already recorded for this appointment and day; null if none.
+         */
+        delivery: {
+            /**
+             * `pending` or `processing` while queued; `accepted` once WhatsApp took it; then `sent`, `delivered` and `read` as WhatsApp reports them; `failed` for good; `superseded` when a newer send replaced it; `unknown` when Ricky cannot tell.
+             */
+            status: 'pending' | 'processing' | 'accepted' | 'sent' | 'delivered' | 'read' | 'failed' | 'superseded' | 'unknown';
+            /**
+             * Why it failed; null otherwise.
+             */
+            error: string | null;
+        } | null;
+    }>;
+};
+/**
+ * What a reminder workflow checked and sent on a past day.
+ */
+export type ReminderHistory = {
     /**
-     * Whether Ricky receives the messages sent to the number.
+     * Day the workflow ran, in its time zone.
      */
-    inbound_processing_enabled: boolean | null;
+    date: string;
     /**
-     * Whether customers can call the number and reach the AI agent.
+     * IANA time zone of the workflow.
      */
-    calls_enabled: boolean | null;
+    timezone: string;
     /**
-     * When it was connected.
+     * Times the workflow checked Odoo that day; 0 for days before Ricky recorded them.
      */
-    connected_at: string | null;
+    evaluations_recorded: number;
     /**
-     * When Ricky last read its details from Meta.
+     * Each appointment the workflow checked or sent that day, oldest first.
      */
-    last_synced_at: string | null;
+    reminders: Array<{
+        /**
+         * Customer first name in Odoo.
+         */
+        customer_first_name: string | null;
+        /**
+         * Phone in Odoo.
+         */
+        phone: string | null;
+        /**
+         * Branch in Odoo.
+         */
+        branch_name: string | null;
+        /**
+         * When the appointment started; null if not recorded.
+         */
+        starts_at: string | null;
+        /**
+         * Why it is not sent: its Odoo state is not one the workflow reminds (`state`), or it has no customer name (`name`), branch (`branch`) or valid phone (`phone`); null when it is sent.
+         */
+        excluded_because: 'state' | 'name' | 'branch' | 'phone' | null;
+        /**
+         * The message sent; null when nothing was sent.
+         */
+        message: string | null;
+        /**
+         * When the workflow last checked the appointment before sending; null if not recorded.
+         */
+        evaluated_at: string | null;
+        /**
+         * When the send was queued; null when nothing was sent.
+         */
+        queued_at: string | null;
+        /**
+         * Where the send stands, with the values of a preview’s `delivery.status`; null when nothing was sent.
+         */
+        status: 'pending' | 'processing' | 'accepted' | 'sent' | 'delivered' | 'read' | 'failed' | 'superseded' | 'unknown' | null;
+        /**
+         * Why it failed; null otherwise.
+         */
+        error: string | null;
+    }>;
 };
 /**
  * An automation Ricky runs for the organization.
@@ -2673,6 +2741,113 @@ export type WorkflowExecution = {
      */
     processed_at: string | null;
 };
+/**
+ * The result of checking a template draft without submitting it.
+ */
+export type TemplateValidation = {
+    /**
+     * Whether `POST /templates` would submit this draft to Meta.
+     */
+    valid: boolean;
+    /**
+     * Every problem found; empty when the draft is valid.
+     */
+    errors: Array<{
+        /**
+         * The request field the problem is in.
+         */
+        param: string;
+        /**
+         * What to change.
+         */
+        message: string;
+    }>;
+    /**
+     * The components Ricky would submit, in the WhatsApp Cloud API format; null when the draft is invalid.
+     */
+    components: Array<{
+        [key: string]: unknown;
+    }> | null;
+};
+/**
+ * A template Meta deleted.
+ */
+export type DeletedTemplate = {
+    /**
+     * Template ID at Meta.
+     */
+    id: string;
+    deleted: true;
+};
+/**
+ * A WhatsApp number, with its status, quality and messaging limit at Meta.
+ */
+export type WhatsAppNumber = {
+    /**
+     * Channel ID.
+     */
+    id: string;
+    /**
+     * Name shown in Ricky.
+     */
+    name: string;
+    /**
+     * Phone in E.164.
+     */
+    phone_number: string | null;
+    /**
+     * Business name Meta approved for the number.
+     */
+    verified_name: string | null;
+    /**
+     * Phone number ID at Meta.
+     */
+    phone_number_id: string | null;
+    /**
+     * WhatsApp Business Account that owns the number.
+     */
+    whatsapp_business_account_id: string | null;
+    /**
+     * `coexistence` when the number also stays on the WhatsApp Business app; `dedicated` otherwise.
+     */
+    connection_mode: 'dedicated' | 'coexistence' | null;
+    /**
+     * Status of the number at Meta, as Meta reports it, for example `CONNECTED`.
+     */
+    status: string | null;
+    /**
+     * When the number was disconnected from Ricky; null while connected.
+     */
+    disconnected_at: string | null;
+    /**
+     * Whether Meta lets the number send: `available`, `limited` or `blocked`.
+     */
+    messaging_health: 'available' | 'limited' | 'blocked';
+    /**
+     * Quality rating at Meta: `green`, `yellow`, `red`, `not_yet_determined` or `unknown`.
+     */
+    quality_rating: string | null;
+    /**
+     * Messaging limit tier at Meta, for example `TIER_1K` or `TIER_UNLIMITED`; `UNKNOWN` when Meta has not reported it.
+     */
+    messaging_limit: string | null;
+    /**
+     * Whether Ricky receives the messages sent to the number.
+     */
+    inbound_processing_enabled: boolean | null;
+    /**
+     * Whether customers can call the number and reach the AI agent.
+     */
+    calls_enabled: boolean | null;
+    /**
+     * When it was connected.
+     */
+    connected_at: string | null;
+    /**
+     * When Ricky last read its details from Meta.
+     */
+    last_synced_at: string | null;
+};
 /**
  * Only `name` is required; it does not connect the agent to any channel.
  */
@@ -3109,26 +3284,94 @@ export type AddContactNote = {
 };
 export type CreateWebhook = {
     /**
-     * Public HTTPS endpoint.
+     * Public HTTPS endpoint.
+     */
+    url: string;
+    event_types: Array<'message.received' | 'message.sent' | 'message.delivered' | 'message.read' | 'message.failed' | 'conversation.opened' | 'conversation.closed' | 'conversation.assignment_changed' | 'conversation.agent_changed' | 'conversation.handoff_requested' | 'conversation.handoff_resolved' | 'contact.created' | 'contact.updated' | 'contact.tags_changed' | 'broadcast.completed' | 'broadcast.failed' | 'template.status_changed' | 'workflow.execution_failed' | 'knowledge_file.ready'>;
+};
+export type RotateWebhookSecret = {
+    /**
+     * How long deliveries keep the previous signature too, so you can deploy the new secret first. 0 ends the previous secret now.
+     */
+    expire_previous_after_hours?: number;
+};
+/**
+ * Sends an approved template to many numbers, now or at a set time.
+ */
+export type CreateBroadcast = {
+    /**
+     * WhatsApp channel to send from. See `GET /channels`.
+     */
+    channel_id: string;
+    template: TemplateMessage;
+    /**
+     * Who receives it. `filter` takes every contact matching all the filters you send (no filter: every contact); `contacts` and `phones` take the ones you list. Ricky uses each contact’s phone, or its WhatsApp number, skips contacts without one and sends once per number, up to 5,000.
+     */
+    audience: {
+        type: 'filter';
+        /**
+         * Only contacts with this tag.
+         */
+        tag_id?: string;
+        /**
+         * Only contacts at this stage.
+         */
+        lifecycle_stage?: 'subscriber' | 'lead' | 'marketing_qualified' | 'sales_qualified' | 'opportunity' | 'customer' | 'evangelist' | 'other';
+        /**
+         * Only contacts whose name, phone, email or company contains it.
+         */
+        query?: string;
+    } | {
+        type: 'contacts';
+        /**
+         * Contacts of the organization.
+         */
+        contact_ids: Array<string>;
+    } | {
+        type: 'phones';
+        /**
+         * Numbers with country code, for example `+50760001234`.
+         */
+        phones: Array<string>;
+    };
+    /**
+     * Fills template variables per recipient from their contact, as the broadcast composer does. Ricky saves them on the template, replacing the ones it had, so later broadcasts of the template use them too; omit it to keep the saved ones, send `[]` to clear them. A recipient without a contact, or without a value in the field, receives the text you sent in `template.components`.
      */
-    url: string;
-    event_types: Array<'message.received' | 'message.sent' | 'message.delivered' | 'message.read' | 'message.failed' | 'conversation.opened' | 'conversation.closed' | 'conversation.assignment_changed' | 'contact.created' | 'contact.updated'>;
-};
-export type RotateWebhookSecret = {
+    mappings?: Array<{
+        /**
+         * Where the variable is: the header, the body, or a URL button.
+         */
+        component: 'header' | 'body' | 'button';
+        /**
+         * The variable: its number (`1`) or its name in a header or body; for a button, the button’s index (`0`).
+         */
+        key: string;
+        /**
+         * Where each recipient’s value comes from.
+         */
+        source: {
+            type: 'contact';
+            /**
+             * A field of the contact.
+             */
+            field: 'birthday' | 'city' | 'company' | 'country' | 'first_name' | 'job_title' | 'last_name' | 'lead_status' | 'lifecycle_stage' | 'linkedin_url' | 'notes' | 'postal_code' | 'primary_email' | 'primary_phone' | 'region' | 'source' | 'street_address' | 'website_url';
+        } | {
+            type: 'custom_field';
+            /**
+             * A custom contact field. See `GET /contact-fields`.
+             */
+            field_id: string;
+        };
+    }>;
     /**
-     * How long deliveries keep the previous signature too, so you can deploy the new secret first. 0 ends the previous secret now.
+     * When to start sending, up to 7 days ahead. Omit it to send now.
      */
-    expire_previous_after_hours?: number;
+    scheduled_at?: string;
 };
 /**
- * Sends an approved template to many numbers, now or at a set time.
+ * The audience to count, as you would send it to `POST /broadcasts`.
  */
-export type CreateBroadcast = {
-    /**
-     * WhatsApp channel to send from. See `GET /channels`.
-     */
-    channel_id: string;
-    template: TemplateMessage;
+export type PreviewBroadcastAudience = {
     /**
      * Who receives it. `filter` takes every contact matching all the filters you send (no filter: every contact); `contacts` and `phones` take the ones you list. Ricky uses each contact’s phone, or its WhatsApp number, skips contacts without one and sends once per number, up to 5,000.
      */
@@ -3159,10 +3402,6 @@ export type CreateBroadcast = {
          */
         phones: Array<string>;
     };
-    /**
-     * When to start sending, up to 7 days ahead. Omit it to send now.
-     */
-    scheduled_at?: string;
 };
 /**
  * Adds and removes the same tags on many contacts. Their other tags stay.
@@ -3518,248 +3757,22 @@ export type UpdateKnowledgeFile = {
      */
     consult_enabled?: boolean;
     /**
-     * Agents may send the file itself.
-     */
-    send_enabled?: boolean;
-};
-/**
- * A template draft. Ricky checks it as `POST /templates/validate` does, then submits it.
- */
-export type CreateTemplate = {
-    /**
-     * WhatsApp channel whose business account will own the template.
-     */
-    channel_id: string;
-    /**
-     * Lowercase letters, digits and underscores, starting with a letter.
-     */
-    name: string;
-    /**
-     * Language code, for example `es` or `en_US`.
-     */
-    language: string;
-    /**
-     * `UTILITY` for updates on something the customer asked for; `MARKETING` otherwise.
-     */
-    category: 'MARKETING' | 'UTILITY';
-    /**
-     * How variables are written: `{{first_name}}` or `{{1}}`. It cannot change later.
-     */
-    parameter_format?: 'NAMED' | 'POSITIONAL';
-    /**
-     * `TEXT` or `LOCATION`. Send `null` for no header.
-     */
-    header?: {
-        type: 'TEXT';
-        /**
-         * Header text; at most one variable.
-         */
-        text: string;
-        /**
-         * Example value of the header variable; required when it has one.
-         */
-        example?: string;
-    } | {
-        type: 'LOCATION';
-    } | null;
-    /**
-     * The message text.
-     */
-    body: {
-        /**
-         * Body text. Variables are `{{1}}`, `{{2}}`… for `POSITIONAL` and `{{first_name}}` for `NAMED`; not at the very start or end.
-         */
-        text: string;
-        /**
-         * An example value for every variable, keyed by its number or name without braces. Meta reviews them.
-         */
-        examples?: {
-            [key: string]: string;
-        };
-    };
-    /**
-     * Footer text, without variables.
-     */
-    footer?: string | null;
-    /**
-     * Quick replies, at most two links and one phone. Quick replies cannot sit between the other buttons.
-     */
-    buttons?: Array<{
-        type: 'QUICK_REPLY';
-        text: string;
-    } | {
-        type: 'URL';
-        text: string;
-        /**
-         * Link the button opens; it may end in the variable `{{1}}`.
-         */
-        url: string;
-        /**
-         * Example URL for a link with `{{1}}`; required when it has one.
-         */
-        example?: string;
-    } | {
-        type: 'PHONE_NUMBER';
-        text: string;
-        /**
-         * Phone the button calls, with country code.
-         */
-        phone_number: string;
-    }>;
-};
-/**
- * The body of `POST /templates`; `channel_id` is optional here.
- */
-export type ValidateTemplate = {
-    /**
-     * WhatsApp channel whose business account will own the template.
-     */
-    channel_id?: string;
-    /**
-     * Lowercase letters, digits and underscores, starting with a letter.
-     */
-    name: string;
-    /**
-     * Language code, for example `es` or `en_US`.
-     */
-    language: string;
-    /**
-     * `UTILITY` for updates on something the customer asked for; `MARKETING` otherwise.
-     */
-    category: 'MARKETING' | 'UTILITY';
-    /**
-     * How variables are written: `{{first_name}}` or `{{1}}`. It cannot change later.
-     */
-    parameter_format?: 'NAMED' | 'POSITIONAL';
-    /**
-     * `TEXT` or `LOCATION`. Send `null` for no header.
-     */
-    header?: {
-        type: 'TEXT';
-        /**
-         * Header text; at most one variable.
-         */
-        text: string;
-        /**
-         * Example value of the header variable; required when it has one.
-         */
-        example?: string;
-    } | {
-        type: 'LOCATION';
-    } | null;
-    /**
-     * The message text.
-     */
-    body: {
-        /**
-         * Body text. Variables are `{{1}}`, `{{2}}`… for `POSITIONAL` and `{{first_name}}` for `NAMED`; not at the very start or end.
-         */
-        text: string;
-        /**
-         * An example value for every variable, keyed by its number or name without braces. Meta reviews them.
-         */
-        examples?: {
-            [key: string]: string;
-        };
-    };
-    /**
-     * Footer text, without variables.
-     */
-    footer?: string | null;
-    /**
-     * Quick replies, at most two links and one phone. Quick replies cannot sit between the other buttons.
-     */
-    buttons?: Array<{
-        type: 'QUICK_REPLY';
-        text: string;
-    } | {
-        type: 'URL';
-        text: string;
-        /**
-         * Link the button opens; it may end in the variable `{{1}}`.
-         */
-        url: string;
-        /**
-         * Example URL for a link with `{{1}}`; required when it has one.
-         */
-        example?: string;
-    } | {
-        type: 'PHONE_NUMBER';
-        text: string;
-        /**
-         * Phone the button calls, with country code.
-         */
-        phone_number: string;
-    }>;
-};
-/**
- * Only the parts you send change; `buttons` replaces every button. Name, language and `parameter_format` cannot change.
- */
-export type UpdateTemplate = {
-    /**
-     * `UTILITY` for updates on something the customer asked for; `MARKETING` otherwise.
-     */
-    category?: 'MARKETING' | 'UTILITY';
-    /**
-     * `TEXT` or `LOCATION`. Send `null` for no header.
-     */
-    header?: {
-        type: 'TEXT';
-        /**
-         * Header text; at most one variable.
-         */
-        text: string;
-        /**
-         * Example value of the header variable; required when it has one.
-         */
-        example?: string;
-    } | {
-        type: 'LOCATION';
-    } | null;
-    /**
-     * The message text.
-     */
-    body?: {
-        /**
-         * Body text. Variables are `{{1}}`, `{{2}}`… for `POSITIONAL` and `{{first_name}}` for `NAMED`; not at the very start or end.
-         */
-        text: string;
-        /**
-         * An example value for every variable, keyed by its number or name without braces. Meta reviews them.
-         */
-        examples?: {
-            [key: string]: string;
-        };
-    };
+     * Agents may send the file itself.
+     */
+    send_enabled?: boolean;
+};
+/**
+ * The file every send of the workflow carries in its template header.
+ */
+export type UploadWorkflowHeaderMedia = {
     /**
-     * Footer text, without variables.
+     * Public HTTPS address Ricky downloads the file from. It must not redirect or resolve to a private address, and its `Content-Type` must be the kind the template header takes (image, video or document) within WhatsApp’s size limit for it.
      */
-    footer?: string | null;
+    url: string;
     /**
-     * Quick replies, at most two links and one phone. Quick replies cannot sit between the other buttons.
+     * Name to keep for the file; defaults to the last part of the URL.
      */
-    buttons?: Array<{
-        type: 'QUICK_REPLY';
-        text: string;
-    } | {
-        type: 'URL';
-        text: string;
-        /**
-         * Link the button opens; it may end in the variable `{{1}}`.
-         */
-        url: string;
-        /**
-         * Example URL for a link with `{{1}}`; required when it has one.
-         */
-        example?: string;
-    } | {
-        type: 'PHONE_NUMBER';
-        text: string;
-        /**
-         * Phone the button calls, with country code.
-         */
-        phone_number: string;
-    }>;
+    file_name?: string;
 };
 /**
  * Creates a conversation workflow as a `draft`. Activating it is a separate call.
@@ -4211,6 +4224,245 @@ export type UpdateWorkflow = {
         };
     };
 };
+/**
+ * A template draft. Ricky checks it as `POST /templates/validate` does, then submits it.
+ */
+export type CreateTemplate = {
+    /**
+     * WhatsApp channel whose business account will own the template.
+     */
+    channel_id: string;
+    /**
+     * Lowercase letters, digits and underscores, starting with a letter.
+     */
+    name: string;
+    /**
+     * Language code, for example `es` or `en_US`.
+     */
+    language: string;
+    /**
+     * `UTILITY` for updates on something the customer asked for; `MARKETING` otherwise.
+     */
+    category: 'MARKETING' | 'UTILITY';
+    /**
+     * How variables are written: `{{first_name}}` or `{{1}}`. It cannot change later.
+     */
+    parameter_format?: 'NAMED' | 'POSITIONAL';
+    /**
+     * `TEXT` or `LOCATION`. Send `null` for no header.
+     */
+    header?: {
+        type: 'TEXT';
+        /**
+         * Header text; at most one variable.
+         */
+        text: string;
+        /**
+         * Example value of the header variable; required when it has one.
+         */
+        example?: string;
+    } | {
+        type: 'LOCATION';
+    } | null;
+    /**
+     * The message text.
+     */
+    body: {
+        /**
+         * Body text. Variables are `{{1}}`, `{{2}}`… for `POSITIONAL` and `{{first_name}}` for `NAMED`; not at the very start or end.
+         */
+        text: string;
+        /**
+         * An example value for every variable, keyed by its number or name without braces. Meta reviews them.
+         */
+        examples?: {
+            [key: string]: string;
+        };
+    };
+    /**
+     * Footer text, without variables.
+     */
+    footer?: string | null;
+    /**
+     * Quick replies, at most two links and one phone. Quick replies cannot sit between the other buttons.
+     */
+    buttons?: Array<{
+        type: 'QUICK_REPLY';
+        text: string;
+    } | {
+        type: 'URL';
+        text: string;
+        /**
+         * Link the button opens; it may end in the variable `{{1}}`.
+         */
+        url: string;
+        /**
+         * Example URL for a link with `{{1}}`; required when it has one.
+         */
+        example?: string;
+    } | {
+        type: 'PHONE_NUMBER';
+        text: string;
+        /**
+         * Phone the button calls, with country code.
+         */
+        phone_number: string;
+    }>;
+};
+/**
+ * The body of `POST /templates`; `channel_id` is optional here.
+ */
+export type ValidateTemplate = {
+    /**
+     * WhatsApp channel whose business account will own the template.
+     */
+    channel_id?: string;
+    /**
+     * Lowercase letters, digits and underscores, starting with a letter.
+     */
+    name: string;
+    /**
+     * Language code, for example `es` or `en_US`.
+     */
+    language: string;
+    /**
+     * `UTILITY` for updates on something the customer asked for; `MARKETING` otherwise.
+     */
+    category: 'MARKETING' | 'UTILITY';
+    /**
+     * How variables are written: `{{first_name}}` or `{{1}}`. It cannot change later.
+     */
+    parameter_format?: 'NAMED' | 'POSITIONAL';
+    /**
+     * `TEXT` or `LOCATION`. Send `null` for no header.
+     */
+    header?: {
+        type: 'TEXT';
+        /**
+         * Header text; at most one variable.
+         */
+        text: string;
+        /**
+         * Example value of the header variable; required when it has one.
+         */
+        example?: string;
+    } | {
+        type: 'LOCATION';
+    } | null;
+    /**
+     * The message text.
+     */
+    body: {
+        /**
+         * Body text. Variables are `{{1}}`, `{{2}}`… for `POSITIONAL` and `{{first_name}}` for `NAMED`; not at the very start or end.
+         */
+        text: string;
+        /**
+         * An example value for every variable, keyed by its number or name without braces. Meta reviews them.
+         */
+        examples?: {
+            [key: string]: string;
+        };
+    };
+    /**
+     * Footer text, without variables.
+     */
+    footer?: string | null;
+    /**
+     * Quick replies, at most two links and one phone. Quick replies cannot sit between the other buttons.
+     */
+    buttons?: Array<{
+        type: 'QUICK_REPLY';
+        text: string;
+    } | {
+        type: 'URL';
+        text: string;
+        /**
+         * Link the button opens; it may end in the variable `{{1}}`.
+         */
+        url: string;
+        /**
+         * Example URL for a link with `{{1}}`; required when it has one.
+         */
+        example?: string;
+    } | {
+        type: 'PHONE_NUMBER';
+        text: string;
+        /**
+         * Phone the button calls, with country code.
+         */
+        phone_number: string;
+    }>;
+};
+/**
+ * Only the parts you send change; `buttons` replaces every button. Name, language and `parameter_format` cannot change.
+ */
+export type UpdateTemplate = {
+    /**
+     * `UTILITY` for updates on something the customer asked for; `MARKETING` otherwise.
+     */
+    category?: 'MARKETING' | 'UTILITY';
+    /**
+     * `TEXT` or `LOCATION`. Send `null` for no header.
+     */
+    header?: {
+        type: 'TEXT';
+        /**
+         * Header text; at most one variable.
+         */
+        text: string;
+        /**
+         * Example value of the header variable; required when it has one.
+         */
+        example?: string;
+    } | {
+        type: 'LOCATION';
+    } | null;
+    /**
+     * The message text.
+     */
+    body?: {
+        /**
+         * Body text. Variables are `{{1}}`, `{{2}}`… for `POSITIONAL` and `{{first_name}}` for `NAMED`; not at the very start or end.
+         */
+        text: string;
+        /**
+         * An example value for every variable, keyed by its number or name without braces. Meta reviews them.
+         */
+        examples?: {
+            [key: string]: string;
+        };
+    };
+    /**
+     * Footer text, without variables.
+     */
+    footer?: string | null;
+    /**
+     * Quick replies, at most two links and one phone. Quick replies cannot sit between the other buttons.
+     */
+    buttons?: Array<{
+        type: 'QUICK_REPLY';
+        text: string;
+    } | {
+        type: 'URL';
+        text: string;
+        /**
+         * Link the button opens; it may end in the variable `{{1}}`.
+         */
+        url: string;
+        /**
+         * Example URL for a link with `{{1}}`; required when it has one.
+         */
+        example?: string;
+    } | {
+        type: 'PHONE_NUMBER';
+        text: string;
+        /**
+         * Phone the button calls, with country code.
+         */
+        phone_number: string;
+    }>;
+};
 /**
  * Optional. A value you choose, unique per logical write, 8–200 characters: a UUID or an ID from your system such as `order-10482-ready`. Retrying with the same key and body replays the first response instead of repeating the write.
  */
@@ -6220,6 +6472,203 @@ export type ListWorkflowExecutionsResponses = {
     };
 };
 export type ListWorkflowExecutionsResponse = ListWorkflowExecutionsResponses[keyof ListWorkflowExecutionsResponses];
+export type UploadWorkflowHeaderMediaData = {
+    body: UploadWorkflowHeaderMedia;
+    headers?: {
+        /**
+         * Optional. A value you choose, unique per logical write, 8–200 characters: a UUID or an ID from your system such as `order-10482-ready`. Retrying with the same key and body replays the first response instead of repeating the write.
+         */
+        'Idempotency-Key'?: string;
+    };
+    path: {
+        /**
+         * Workflow ID.
+         */
+        workflow_id: string;
+    };
+    query?: never;
+    url: '/workflows/{workflow_id}/header-media';
+};
+export type UploadWorkflowHeaderMediaErrors = {
+    /**
+     * `invalid_json`: The body is not valid JSON.
+     *
+     * `invalid_input`: A parameter or body field is invalid; `param` names it when known.
+     */
+    400: Error;
+    /**
+     * `unauthorized`: The `Authorization` header is missing, malformed, expired or revoked.
+     */
+    401: Error;
+    /**
+     * `insufficient_scope`: The key lacks the scope this operation requires.
+     */
+    403: Error;
+    /**
+     * `not_found`: The resource does not exist in this organization.
+     */
+    404: Error;
+    /**
+     * `idempotency_conflict`: The `Idempotency-Key` was used for a different request.
+     *
+     * `request_processing`: A request with this `Idempotency-Key` is still processing or ended in an unknown state.
+     */
+    409: Error;
+    /**
+     * `body_too_large`: The JSON body exceeds 64 KiB.
+     */
+    413: Error;
+    /**
+     * `unsupported_media_type`: The body must be `application/json`.
+     */
+    415: Error;
+    /**
+     * `rule_violation`: The request breaks a business rule; `message` says which.
+     */
+    422: Error;
+    /**
+     * `rate_limited`: More than 120 requests this minute with this key; see `Retry-After`.
+     */
+    429: Error;
+    /**
+     * `internal_error`: Ricky failed. Retry a read. Before retrying a write, read the resource: the same `Idempotency-Key` answers `request_processing`.
+     */
+    500: Error;
+    /**
+     * `upstream_error`: The messaging provider failed. Retry later.
+     */
+    502: Error;
+};
+export type UploadWorkflowHeaderMediaError = UploadWorkflowHeaderMediaErrors[keyof UploadWorkflowHeaderMediaErrors];
+export type UploadWorkflowHeaderMediaResponses = {
+    /**
+     * Success.
+     */
+    200: {
+        data: Workflow;
+    };
+};
+export type UploadWorkflowHeaderMediaResponse = UploadWorkflowHeaderMediaResponses[keyof UploadWorkflowHeaderMediaResponses];
+export type PreviewWorkflowRemindersData = {
+    body?: never;
+    path: {
+        /**
+         * Workflow ID.
+         */
+        workflow_id: string;
+    };
+    query: {
+        /**
+         * Day the workflow would send, `YYYY-MM-DD` in its time zone: its next run or a later day.
+         */
+        date: string;
+        /**
+         * Odoo states to remind instead of the workflow’s, comma-separated, to see what a change would do. Omit it to use the workflow’s.
+         */
+        appointment_states?: string;
+    };
+    url: '/workflows/{workflow_id}/reminders/preview';
+};
+export type PreviewWorkflowRemindersErrors = {
+    /**
+     * `invalid_input`: A parameter or body field is invalid; `param` names it when known.
+     */
+    400: Error;
+    /**
+     * `unauthorized`: The `Authorization` header is missing, malformed, expired or revoked.
+     */
+    401: Error;
+    /**
+     * `insufficient_scope`: The key lacks the scope this operation requires.
+     */
+    403: Error;
+    /**
+     * `not_found`: The resource does not exist in this organization.
+     */
+    404: Error;
+    /**
+     * `rule_violation`: The request breaks a business rule; `message` says which.
+     */
+    422: Error;
+    /**
+     * `rate_limited`: More than 120 requests this minute with this key; see `Retry-After`.
+     */
+    429: Error;
+    /**
+     * `internal_error`: Ricky failed. Retry a read. Before retrying a write, read the resource: the same `Idempotency-Key` answers `request_processing`.
+     */
+    500: Error;
+    /**
+     * `upstream_error`: The messaging provider failed. Retry later.
+     */
+    502: Error;
+};
+export type PreviewWorkflowRemindersError = PreviewWorkflowRemindersErrors[keyof PreviewWorkflowRemindersErrors];
+export type PreviewWorkflowRemindersResponses = {
+    /**
+     * Success.
+     */
+    200: {
+        data: ReminderPreview;
+    };
+};
+export type PreviewWorkflowRemindersResponse = PreviewWorkflowRemindersResponses[keyof PreviewWorkflowRemindersResponses];
+export type GetWorkflowReminderHistoryData = {
+    body?: never;
+    path: {
+        /**
+         * Workflow ID.
+         */
+        workflow_id: string;
+    };
+    query: {
+        /**
+         * Day the workflow ran, `YYYY-MM-DD` in its time zone.
+         */
+        date: string;
+    };
+    url: '/workflows/{workflow_id}/reminders/history';
+};
+export type GetWorkflowReminderHistoryErrors = {
+    /**
+     * `invalid_input`: A parameter or body field is invalid; `param` names it when known.
+     */
+    400: Error;
+    /**
+     * `unauthorized`: The `Authorization` header is missing, malformed, expired or revoked.
+     */
+    401: Error;
+    /**
+     * `insufficient_scope`: The key lacks the scope this operation requires.
+     */
+    403: Error;
+    /**
+     * `not_found`: The resource does not exist in this organization.
+     */
+    404: Error;
+    /**
+     * `rule_violation`: The request breaks a business rule; `message` says which.
+     */
+    422: Error;
+    /**
+     * `rate_limited`: More than 120 requests this minute with this key; see `Retry-After`.
+     */
+    429: Error;
+    /**
+     * `internal_error`: Ricky failed. Retry a read. Before retrying a write, read the resource: the same `Idempotency-Key` answers `request_processing`.
+     */
+    500: Error;
+};
+export type GetWorkflowReminderHistoryError = GetWorkflowReminderHistoryErrors[keyof GetWorkflowReminderHistoryErrors];
+export type GetWorkflowReminderHistoryResponses = {
+    /**
+     * Success.
+     */
+    200: {
+        data: ReminderHistory;
+    };
+};
+export type GetWorkflowReminderHistoryResponse = GetWorkflowReminderHistoryResponses[keyof GetWorkflowReminderHistoryResponses];
 export type GetDashboardReportData = {
     body?: never;
     path?: never;
@@ -9603,6 +10052,58 @@ export type FetchMessageMediaResponses = {
     };
 };
 export type FetchMessageMediaResponse = FetchMessageMediaResponses[keyof FetchMessageMediaResponses];
+export type PreviewBroadcastAudienceData = {
+    body: PreviewBroadcastAudience;
+    path?: never;
+    query?: never;
+    url: '/broadcasts/preview';
+};
+export type PreviewBroadcastAudienceErrors = {
+    /**
+     * `invalid_json`: The body is not valid JSON.
+     *
+     * `invalid_input`: A parameter or body field is invalid; `param` names it when known.
+     */
+    400: Error;
+    /**
+     * `unauthorized`: The `Authorization` header is missing, malformed, expired or revoked.
+     */
+    401: Error;
+    /**
+     * `insufficient_scope`: The key lacks the scope this operation requires.
+     */
+    403: Error;
+    /**
+     * `not_found`: The resource does not exist in this organization.
+     */
+    404: Error;
+    /**
+     * `body_too_large`: The JSON body exceeds 64 KiB.
+     */
+    413: Error;
+    /**
+     * `unsupported_media_type`: The body must be `application/json`.
+     */
+    415: Error;
+    /**
+     * `rate_limited`: More than 120 requests this minute with this key; see `Retry-After`.
+     */
+    429: Error;
+    /**
+     * `internal_error`: Ricky failed. Retry a read. Before retrying a write, read the resource: the same `Idempotency-Key` answers `request_processing`.
+     */
+    500: Error;
+};
+export type PreviewBroadcastAudienceError = PreviewBroadcastAudienceErrors[keyof PreviewBroadcastAudienceErrors];
+export type PreviewBroadcastAudienceResponses = {
+    /**
+     * Success.
+     */
+    200: {
+        data: BroadcastAudiencePreview;
+    };
+};
+export type PreviewBroadcastAudienceResponse = PreviewBroadcastAudienceResponses[keyof PreviewBroadcastAudienceResponses];
 export type WebhookMessageReceivedWebhookPayload = WebhookEvent;
 export type WebhookMessageReceivedWebhookRequest = {
     body: WebhookMessageReceivedWebhookPayload;
@@ -9659,6 +10160,27 @@ export type WebhookConversationAssignmentChangedWebhookRequest = {
     path?: never;
     query?: never;
 };
+export type WebhookConversationAgentChangedWebhookPayload = WebhookEvent;
+export type WebhookConversationAgentChangedWebhookRequest = {
+    body: WebhookConversationAgentChangedWebhookPayload;
+    key: 'conversation.agent_changed';
+    path?: never;
+    query?: never;
+};
+export type WebhookConversationHandoffRequestedWebhookPayload = WebhookEvent;
+export type WebhookConversationHandoffRequestedWebhookRequest = {
+    body: WebhookConversationHandoffRequestedWebhookPayload;
+    key: 'conversation.handoff_requested';
+    path?: never;
+    query?: never;
+};
+export type WebhookConversationHandoffResolvedWebhookPayload = WebhookEvent;
+export type WebhookConversationHandoffResolvedWebhookRequest = {
+    body: WebhookConversationHandoffResolvedWebhookPayload;
+    key: 'conversation.handoff_resolved';
+    path?: never;
+    query?: never;
+};
 export type WebhookContactCreatedWebhookPayload = WebhookEvent;
 export type WebhookContactCreatedWebhookRequest = {
     body: WebhookContactCreatedWebhookPayload;
@@ -9673,6 +10195,48 @@ export type WebhookContactUpdatedWebhookRequest = {
     path?: never;
     query?: never;
 };
+export type WebhookContactTagsChangedWebhookPayload = WebhookEvent;
+export type WebhookContactTagsChangedWebhookRequest = {
+    body: WebhookContactTagsChangedWebhookPayload;
+    key: 'contact.tags_changed';
+    path?: never;
+    query?: never;
+};
+export type WebhookBroadcastCompletedWebhookPayload = WebhookEvent;
+export type WebhookBroadcastCompletedWebhookRequest = {
+    body: WebhookBroadcastCompletedWebhookPayload;
+    key: 'broadcast.completed';
+    path?: never;
+    query?: never;
+};
+export type WebhookBroadcastFailedWebhookPayload = WebhookEvent;
+export type WebhookBroadcastFailedWebhookRequest = {
+    body: WebhookBroadcastFailedWebhookPayload;
+    key: 'broadcast.failed';
+    path?: never;
+    query?: never;
+};
+export type WebhookTemplateStatusChangedWebhookPayload = WebhookEvent;
+export type WebhookTemplateStatusChangedWebhookRequest = {
+    body: WebhookTemplateStatusChangedWebhookPayload;
+    key: 'template.status_changed';
+    path?: never;
+    query?: never;
+};
+export type WebhookWorkflowExecutionFailedWebhookPayload = WebhookEvent;
+export type WebhookWorkflowExecutionFailedWebhookRequest = {
+    body: WebhookWorkflowExecutionFailedWebhookPayload;
+    key: 'workflow.execution_failed';
+    path?: never;
+    query?: never;
+};
+export type WebhookKnowledgeFileReadyWebhookPayload = WebhookEvent;
+export type WebhookKnowledgeFileReadyWebhookRequest = {
+    body: WebhookKnowledgeFileReadyWebhookPayload;
+    key: 'knowledge_file.ready';
+    path?: never;
+    query?: never;
+};
 export type WebhookWebhookTestWebhookPayload = WebhookEvent;
 export type WebhookWebhookTestWebhookRequest = {
     body: WebhookWebhookTestWebhookPayload;