Actions a_form_chat

Form (Conversational)

Collects structured data over a text channel by asking the next missing field as a natural-language question.

What does it do?

Collects user data conversationally, asking one field at a time.

How does it work?

You give it a list of questions (e.g. name, phone). The assistant asks the user one by one via chat and stores the answers.

Why use it?

Perfect for WhatsApp or Instagram, where you can't show a web form but need to capture precise data step by step.

Inputs

name	type
`text`	string

Outputs

name	type
`branch`	string
`form_id`	string
`channel_mode`	string
`values`	object
`pending_fields`	array
`asked_question`	string
`errors`	object

Branches

Fixed branches

awaiting — Awaiting
complete — Complete

Configuration

—

Default configuration

{
  "form_id": "form_main",
  "fields": [
    {
      "name": "name",
      "label": "Name",
      "type": "text",
      "required": true
    },
    {
      "name": "email",
      "label": "Email",
      "type": "email",
      "required": true
    }
  ],
  "awaiting_branch": "awaiting",
  "complete_branch": "complete",
  "llm_role": "chatbot",
  "llm_temperature": 0.2,
  "llm_max_tokens": 400,
  "max_turns": 8
}

Emitted events

This node does not publish events on the pubsub channel.