WebhookPayload

Webhook delivery body. Always exactly one entry in messages — Landbot never batches.

  • messages
    Type: array · WebhookMessage[]
    required

    • A single webhook message. Discriminated on type.

      A single webhook message. Discriminated on type.

      • type
        Discriminator
        enum
        const:  
        text
        required
        values
        • text
      • channel
        Type: object · WebhookChannel
        required

        The channel the customer is conversing on.

      • customer
        Type: object · WebhookCustomer
        required

        The customer this message belongs to. Custom variables (Fields/Hidden Fields) appear as ADDITIONAL top-level keys here and may be type-mangled (e.g. a list arrives as the Python-repr string "['a','b']"). Treat custom values as strings unless the source block guarantees otherwise.

      • data
        Type: object
        required
      • sender
        Type: object · WebhookSender
        required

        Who originated this message.

      • timestamp
        Type: number
        required

        Unix epoch SECONDS (not ms, not ISO). Web → microsecond float; WhatsApp customer-sent → integer; WhatsApp bot/agent-sent → float. Preserved across retries.

      • _raw
        Type: object · WebhookRaw

        The unwrapped raw message as Landbot represents it internally — fields not surfaced in data.