Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.cogniagent.ai/llms.txt

Use this file to discover all available pages before exploring further.

Initiator flows don’t wait for inbound traffic. You start each conversation manually (from the editor) or programmatically (from a workflow).

​
When to use this

  • An account manager places an outbound sales call.
  • A renewal team kicks off a “your contract is up for renewal” email.
  • A workflow node fires a follow-up SMS after a webhook trigger.
  • A scheduled job opens daily check-in conversations.
The flow must be in Initiator execution mode. See Execution modes.

​
Starting from the editor

1

Click Start Conversation

Bottom toolbar. The button appears in place of Deploy when the flow’s execution mode is Initiator.
2

Pick a channel

Only channels that support outbound traffic appear — Gmail, Outlook, Slack, Teams, Phone, SMS, WhatsApp Business.
3

Enter the recipient

Channel-specific recipient field:
ChannelWhat to enter
Gmail / OutlookEmail address
SlackUser ID or channel ID (the modal helps you pick)
TeamsUser or chat ID
PhoneE.164 number (+15551234567)
SMS / WhatsAppE.164 number
4

Fill in initial parameters

If the flow defines Initial Parameters, the form shows those fields. Common ones:
  • customer_name
  • account_id
  • purpose_of_call
5

Optional — provide a global task

A free-text “what is this conversation about” you give the first actor. Often more useful than structured parameters.
“Reach out to Sarah from Acme Logistics about her renewal. Her contract ends Aug 31. Her main concern is pricing — be ready to discuss options.”
6

Start

The flow opens the conversation. The first actor sends an opener.For email: an email lands in the recipient’s inbox.For Slack/Teams: a message appears in their DMs.For phone: the platform places the call.

​
After the opener

What happens next depends on the channel:
  • Email — the recipient replies in-thread. The reply lands back in this conversation and the next actor turn fires.
  • Messaging — the recipient sends a Slack/Teams reply. Same loop.
  • Phone — the caller answers (or doesn’t). If they pick up, the conversation continues turn by turn.
  • SMS / WhatsApp — same as email/messaging.
The conversation is visible in Conversations history with the recipient as participant.

​
Conflict with an existing active conversation

If the recipient already has an active conversation with this flow, the platform asks what to do:
  • Use existing — your message goes into the existing thread. The actor sees it as the next user turn.
  • Replace — the existing conversation is closed and a new one starts.
This prevents accidental duplicates — useful when multiple teammates might kick off conversations to the same customer.

​
Starting from a workflow

In an Application workflow, use the Conversation Flow action node:
  1. Drop the node onto your canvas.
  2. Pick the flow you want to start.
  3. Map workflow variables onto the flow’s Initial Parameters.
  4. Wire the node into your workflow.
The flow starts as part of the workflow execution. The opener is sent, and the conversation continues independently — the workflow doesn’t wait for the conversation to finish unless you configure it to.

​
Anti-patterns

Don’t use Start Conversation as a bulk send. This UI is for one-off outreach. For bulk campaigns, use a workflow that calls the Conversation Flow action node, driven by a list trigger.
Don’t kick off real conversations during testing. Use the Test drawer — it short-circuits channel delivery. Real Start Conversation calls do send real messages.

​
Next

Test a flow

Try the flow without sending real messages.

Conversations history

Track everything that’s been started.