How can we help?

WhatsApp Handover
9 min
Created by Maria Malheiro on 11/18/2026 3:38 PM
Updated by Maria Malheiro on 11/18/2026 6:20 PM

WhatsApp Handover allows you to define, directly in the WhatsApp action of a SenseData rule, which team or agent will receive the replies sent by contacts in Zenvia Customer Cloud.

With this feature, you can choose between two routing options:

  • Service Teams: routes the conversation to a team's service queue.

  • Service Agent: routes the conversation to a specific agent assigned to the selected team.

Previously, replies to messages sent by rules were forwarded generically to the configured service module. As a result, manual triage was required to identify each conversation and assign it to the appropriate person.

With WhatsApp Handover, this process is automated. Simply define the destination when configuring the rule, and when the contact replies to the message, the conversation will be forwarded directly to the selected team or agent.

1. How does it work?

The handover process takes place in three steps:

  1. A SenseData rule is executed and triggers a WhatsApp message template to be sent to the contact.

  2. The contact replies to the message received.

  3. A conversation is initiated in the Zenvia Customer Cloud service module and automatically routed to the team or agent previously defined in the rule.

Key benefits

  • Accurate routing: replies are sent directly to the team or agent responsible for handling the conversation.

  • Faster service: eliminates the need for manual triage, reducing the time between the contact's reply and the start of human support.

  • Configuration autonomy: allows you to define the conversation destination directly when creating or editing a rule, without relying on the support team.

  • Backward compatibility: existing rules continue to work normally, with no migration or adjustments required.

2. Before you start

Before configuring WhatsApp Handover, you must check a few prerequisites to ensure that the feature is available and works correctly.

General WhatsApp Handover parameter

This parameter must be enabled for the company by the SenseData team. It is not available for configuration by the customer's Administrator profile.

Reply routing

The reply routing parameter must be enabled on the platform to allow conversations to be forwarded.

Service Module

Currently, WhatsApp Handover is available for the Commercial Service module. Therefore, this must be the option selected when configuring the rule.

Zenvia Customer Cloud integration

You must have an active connection to Zenvia Customer Cloud. This integration allows the platform to retrieve and display the available service teams and agents for routing configuration.

Important: If any of these prerequisites are not met, the configuration may not be available, or routing may not work as expected.

3. How to configure WhatsApp Handover

Configuration is performed directly in the WhatsApp sending action when creating or editing a rule in SenseData.

Image

Follow the steps below to configure it:

Configuration step by step

1. Access the rule

On the SenseData rule creation or editing screen, add a new WhatsApp action or select an existing action to edit it.

2. Configure the message

Select the Sender and the Template that will be used to send the message to the contact.

3. Configure reply routing

In the Reply Routing section, select the service module that will receive the conversations.

To use WhatsApp Handover, select Commercial Service.

4. Define the assignment type

In the Assign to field, choose how you want incoming replies to be routed:

  • Service Teams: select this option if you want conversations to be forwarded to a team's queue, allowing team members to handle them.

  • Service Agent: select this option if you want conversations to be routed to a specific agent belonging to the selected team.

5. Select the service team

In the Teams field, select the team that should receive the conversations. The list displays only teams enabled in Zenvia Customer Cloud and available for use with this feature.

6. Select the service agent (optional)

This step is required only when Service Agent has been selected in the Assign to field. In this case, the Service Agent field will become available, allowing you to select the person responsible for receiving the conversations.

The list displays only agents assigned to the selected team. If an agent is offline, their status will be displayed as Unavailable.

7. Save the configuration

After completing the required fields, click Save to confirm the rule changes.

That's it! The rule is now configured to automatically route contacts' replies to the selected team or agent.

4. Important rules and behavior

To use WhatsApp Handover correctly, it is important to understand a few configuration rules and how the feature works.

4.1. Optional configuration

WhatsApp Handover is an optional feature. This means that you are not required to define a team or agent to use a WhatsApp action in a rule.

If no specific destination is configured, the rule will continue to use the previous default forwarding behavior (legacy behavior).

Therefore, existing rules will continue to work normally, with no changes or migration required.

4.2. Required fields

The required fields vary according to the selected assignment type:

  • Service Teams: selecting a team is mandatory.

  • Service Agent: selecting both a team and an agent assigned to that team is mandatory.

Therefore, it is not possible to route a conversation to a specific agent without first defining the team they belong to.

4.3. Automatic field clearing

To prevent inconsistent configurations, some fields are automatically cleared when certain changes are made.

See how this works:

  • Changing the assignment type: when switching between Service Teams and Service Agent, the team and agent fields are reset. You must select them again.

  • Changing the team: when a different team is selected, the previously selected agent is automatically removed. This is because the agent may not belong to the new team.

  • Changing the service module: if a module that does not support handover is selected, the entire routing configuration is cleared.

4.4. Team listing

The list of available teams includes only those properly enabled in Zenvia Customer Cloud. If an expected team does not appear in the list, check whether it is enabled and correctly configured on the platform.

4.5. Agent availability

Agents identified as Unavailable can also be selected when configuring the rule.

However, the actual conversation assignment depends on the agent's availability status in Zenvia Customer Cloud at the time the contact replies to the message.

This means that the status displayed during configuration does not guarantee that the agent will be available when the handover takes place.

Important: selecting an agent in the rule defines the intended destination for the conversation, but the actual assignment takes the agent's availability into account when the reply is received.

Did this article solve your doubts?
Recently viewed