# 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.

Updated Nov 17, 2026. Source: https://smallbusinesschatbot.com/docs/workflows/triggers/conversation-action-called

## What this does

Small Business Chatbot starts a run in every published workflow with this trigger when a [Conversation Action](https://smallbusinesschatbot.com/docs/user-guides/conversation-actions) 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](https://smallbusinesschatbot.com/docs/workflows/steps/text) step to `{{trigger.contact.phone}}`. To email the customer, add a [Find Contact](https://smallbusinesschatbot.com/docs/workflows/steps/crm-steps#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](https://smallbusinesschatbot.com/docs/workflows/triggers/chat-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:

```json 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

- [Start a workflow](https://smallbusinesschatbot.com/docs/user-guides/conversation-actions/start-a-workflow): add the step and build the workflow.
- [Triggers](https://smallbusinesschatbot.com/docs/user-guides/workflows/triggers): how to pick a trigger.
- [Variables](https://smallbusinesschatbot.com/docs/workflows/variables): how `{{trigger.…}}` values are filled in.
