Skip to content
Small Business Chatbot Docs
Support Open the app

Conversation Action called

Start a workflow when a Conversation Action reaches its Start a workflow step, with the action's parameters and the fields its steps kept.

What this does

Small Business Chatbot starts a run in every published workflow with this trigger when a Conversation Action reaches its Start a workflow step during a website chat, a text conversation or a phone call. The conversation carries on while the workflow runs.

Label in the app
Conversation Action called
Fires
When an action reaches its Start a workflow step
Carries
The action, the channel, the contact, the parameters and the fields earlier steps kept, as {{trigger.…}}
Settings
Action

When it fires

  • Once each time an action reaches the step. The steps before it have succeeded by then.
  • For the same action with the same details on the same customer message, once.
  • From the action editor's Test too. Those runs carry trigger.is_test_run set to true.
  • Within the action's limits on runs that change something: 1 per customer message, 3 per conversation in 24 hours and 150 per workspace in 24 hours.

Action

The trigger's one setting. It decides which actions start the workflow.

Option Starts the workflow for
All Conversation Actions with a workflow step Every action that has a Start a workflow step. The default.
An action's name That action only. An action listed with "(no "Start a workflow" step yet)" starts the workflow once the step is added to it.

The trigger keeps the action itself, so renaming the action leaves the workflow working. When the action is deleted, the list shows Deleted action with "The action this workflow listened for was deleted. Choose another action, or all actions."

What it carries

Variable Type What it holds
trigger.action.name text The action's name
trigger.action.action_id id The action's id
trigger.channel text chat, text or phone
trigger.conversation_id id The conversation's id. On a call, the call's id.
trigger.contact.phone text The phone number of the caller or of the person texting, as the phone carrier reports it. It is empty for a website chat.
trigger.contact.email, trigger.contact.name text Empty in a conversation. A test run fills the email from Contact's email.
trigger.parameters.* object The details the AI receptionist collected, by parameter name, such as trigger.parameters.summary
trigger.steps.* object Every field the earlier steps kept, by step name and field name, such as trigger.steps.create_ticket.ticket_id
trigger.is_test_run true or false true when the run came from Test

Which values come from the customer

Group Comes from Use it for
trigger.contact The channel: the number the call or text comes from Where a text or an email goes
trigger.parameters The customer, as said or typed. Nobody has checked it. What a message says
trigger.steps Your lookup table or your own system What a message says

Send texts and emails to contact, such as a Send Text step to {{trigger.contact.phone}}. To email the customer, add a Find Contact step that looks the contact up by {{trigger.contact.phone}}, and send to the email it finds. For website chats, follow up from Chat Widget Conversation Ended, which carries the phone and email the visitor gave.

Example

A run started on a phone call by an action named Create support ticket:

trigger
{
  "action": { "action_id": "0b6f2d1e", "name": "Create support ticket" },
  "channel": "phone",
  "conversation_id": "CA3f9c",
  "contact": { "phone": "+16135550142", "email": null, "name": null },
  "parameters": { "summary": "The heating stopped working this morning" },
  "steps": { "create_ticket": { "ticket_id": "48213" } },
  "is_test_run": false
}

Used in

Next steps