Skip to main content

Calls and WhatsApp sequence

When a contact doesn't pick up, your agent can follow up on its own: call again later, send a WhatsApp template, wait for a reply, and call once more. You build that sequence in the agent editor, turn by turn, and the conversation decides whether it keeps going.

Before you start​

  • A connected WhatsApp number. The sequence sends WhatsApp templates, so the option stays disabled until your company has a number connected. See WhatsApp Business.
  • An agent answering that number. Assign an inbound agent to the WhatsApp number in Telephones → Assign agents to telephones. That agent handles the replies.
  • Success criteria on that inbound agent, unless you write a rule in the sequence itself (see Keep going after someone answers). They decide whether a WhatsApp conversation went well.
  • At least one approved template on the WhatsApp number. Create templates under Templates. Only templates with status Approved can be picked.

Turn it on​

  1. Open the agent and click Edit Agent.
  2. Open the Medium tab.
  3. Under When a call isn't answered, choose Calls and WhatsApp sequence.

ChoiceWhat happens
Do nothingOne call per contact.
Call againRetries the call on a schedule (the retry waits you already know).
Calls and WhatsApp sequenceMixes calls with WhatsApp templates. The conversation decides whether to keep going.

The three are exclusive: picking the sequence turns plain retries off. A new sequence starts as one call followed by a WhatsApp when it is missed, and the editor opens so you can choose the template.

  1. Complete the sequence (next section), click Done, then Update to publish the agent.

Outside edit mode, the Medium tab shows the sequence as a row of steps:

The sequence editor​

Click Edit sequence to open the editor. It has three parts.

Send WhatsApp from​

The WhatsApp number the templates are sent from. With a single connected number it is chosen for you. Under the field you see which agent handles the replies and after how many hours without messages a conversation closes. See WhatsApp conversations for how a conversation closes and how it is judged.

Changing to a number on a different WhatsApp account clears the templates you picked, because templates belong to the account.

Sequence​

Turns run from top to bottom. Each one is a Call or a WhatsApp template, and each starts after its wait.

  • Turn 1 is always a call. It is the call that starts the sequence: from a task (Excel, HubSpot, Google Sheets), the API, or another agent.
  • Wait is in minutes (0 to 10080, which is 7 days). The editor shows it in hours and days next to the field.
    • Before a turn that follows a call, the wait counts from the moment the call went unanswered.
    • Before a turn that follows a WhatsApp, it counts from the moment that conversation ended without success.
    • A WhatsApp with wait 0 right after a call is sent right after the call. Any other wait of 0 means the next open slot.
    • Waits follow the agent's retry schedule (its open hours, shown below the sequence on the Medium tab), including what a wait that runs past closing time does.
  • WhatsApp turns need an approved template. The editor shows the message as the contact will get it, plus one field per placeholder ({{1}}, {{2}}, …). Fill each with a call variable such as {{name}} or with fixed text. Every placeholder needs a value, otherwise the message is not sent.
  • After a WhatsApp turn the conversation runs. If it ends without success, or nobody replies, the next turn follows.
  • If the contact writes while a WhatsApp turn is still waiting, that message is held and the conversation is judged first. If it ends without success, the wait starts over.
  • The last turn ends the sequence. A final WhatsApp is just a message (a later reply is handled as a normal incoming conversation). If the last turn is a call and it isn't answered, the contact ends as not contacted.

Use + Add call and + Add WhatsApp to add turns, and the bin icon to remove one. The sequence needs at least one WhatsApp turn; for calls only, choose Call again instead.

Keep going after someone answers​

A missed call always moves the sequence forward. This setting decides what happens after an answered call:

OptionThe sequence keeps going when…
Never. An answered call ends the sequenceNever.
When the call misses this agent's success criteriaThe call's success evaluation (from the success criteria in the Instructions tab) comes back unsuccessful.
When an output variable is trueThe output variable you pick comes back true.
When a rule written here is metThe rule you write (up to 2000 characters) matches the call transcript.

With a rule, the same rule also judges the WhatsApp conversations of the sequence, so the inbound agent needs no success criteria of its own. With any other option, WhatsApp conversations are judged by the inbound agent's success criteria.

When no evaluation is available, the sequence stops: a failed analysis never sends more calls or messages to someone who already picked up.

Editing a live sequence

Changes also apply to contacts who are already in the sequence.

Errors and warnings​

When you click Update, the editor marks what is missing. Some notes also show while you edit:

MessageWhat to do
Choose the WhatsApp number the sequence sends fromPick a number under Send WhatsApp from.
The sequence needs at least one WhatsApp turnAdd a WhatsApp turn, or choose Call again for calls only.
Choose a template for every WhatsApp in the sequencePick an approved template on each WhatsApp turn.
Every template variable in the sequence needs a valueFill every {{placeholder}} field.
Sequence waits must be whole minutes between 0 and 10080Fix the wait.
Write the rule for when the sequence keeps goingThe rule option needs text (up to 2000 characters).
Choose the output variable that keeps the sequence goingPick an output variable, or add one in Instructions.
This number has no agent answering itAssign an inbound agent to the WhatsApp number in Telephones.
Agent has no success criteria, so its conversations cannot be judgedAdd success criteria to that agent, or use a rule.
This template is not approved or no longer exists on this numberPick another template.