Skip to main content
Human Handover via Zapier is available on the following plans: Advanced, Business and Enterprise.
You can set up an automation to forward conversations to your inbox. This way you will receive an email so a human can follow up the chat. To make this happen, we need to tell the Agent when to handover the conversation, which data it needs to collect and we need to build an automation to make sure the data is forwarded to the email. What you need:
  1. Advanced/Business/Enterprise plan
  2. Admin rights for API keys
  3. Zapier paid plan
  4. Access to email account

1. Set up Human handover

Start by setting up Human Handover in Watermelon. The Handover is needed so the Agent knows in which cases the Agent needs to forward conversations. The handover triggers the automation in Zapier which forwards the conversation to your email.
How does handover work?Agent collects details → customer types trigger → Human Handover fires → Zapier sends email.
1

Open Human Handover in Watermelon

Go to Situations and go to Human Handover.
Handover Menu
2

Allow Human Handover outside office hours

Decide if you want to forward conversations outside office hours. If you turn on the toggle, conversations outside business hours will also be forwarded to your email.
Handover Outside Business Hours
3

Add instructions

To manage expectations for the end-user, you can add instructions for the Agent what it needs to say during/outside office hours. Example:
Your request has been submitted. Our team will reach out as soon as possible.
Handover Instructions
Be aware that after the Handover your Agent has left the Chat. You can include this information in the instructions above.
4

Create Trigger

To technically trigger the handover, we need a code word. We call this code word a trigger. When a customer types this trigger, the message is automatically forwarded.Click Create to create a new Trigger and select new in the dropdown menu.Suggested trigger: Submit request.
Handover Trigger
It’s important to choose a trigger sentence which is not used in conversations often. Otherwise the automation might be triggered without all necessary data.

2. Write instruction

Now the Handover is set-up, you need to make sure the Agent collects all needed information, before forwarding the conversation.
1

Create new Instruction

In the Agent settings, go to Instructions and click Create to create a new instruction.
Instruction Handover
2

Write instruction

Write an instruction where you explain the following to the Agent:
  1. In which case does the Agent Handover the conversation.
  2. Add a list of all items the Agent needs to collect before the handover.
  3. Lastly add the Handover trigger. This trigger should be the same combination of words you used in the set up of the Handover above.
    Example:
When someone asks for an offer, you ask the following details from the customer:
  1. Name
  2. Email address
  3. Phone number When you received this information, you ask the person to write Submit request. This way, an employee can reach out.
Instruction Handover

3. Create automation

Now everything is set up in Watermelon, we can create the automation in Zapier. This automation will make sure your chats will actually be forwared to your email.
1

Open Zapier in Apps

In Watermelon, go to Apps and open Zapier.
Zapier Integrations
2

Select App and workflow

In the next screen, select the App you use for email. Also select the workflow: hand over conversation agent in Watermelon and send email. If this workflow does not pop up, select Create from scratch.
Zapier Create From Scratch
3

Connect Watermelon to Zapier

When you click use this workflow or Create from scratch, Zapier will open in a new screen.It should show as the image below. Click Select to connect Watermelon to Zapier.
Forward Conversations Email Connect Pn
4

Add API Keys

A new screen will open where you need to add API keys.
Forward Conversations Email Zapier Api Keys Pn
5

Create API Key

In Watermelon, go to API keys and click Create to create a new API key.Give the API Key a name and make sure to select Read and write. Read and write permissions are needed so the API can collect and use the correct details.Add the keys to the Zapier fields.
Zapier Api Key
Zapier Create Api Key
6

Test connection

In Zapier, click on continue to test the connection with Watermelon.
Forward Conversations Email Api Key Test Connection Pn
You need a conversation in your inbox to test this step. Follow these steps if no conversations are handed off:
  1. Open your Chat Widget
  2. Start a conversation
  3. Use the Trigger word you set up in step 1 of this article.
  4. After the conversation is handed off in Watermelon, click Find new records in Zapier. Your new conversation should show up.
7

Add AI by Zapier

AI by Zapier is a paid service, you can also skip this step and load the full message payload into the email.
Click on the plus button to add an extra step and select AI by Zapier.
Forward Conversations Email Extra Step Pn
8

Set up AI by Zapier

  1. In the input field, click on the Plus button and select Message payload.
Forward Conversations Email Input Field Pn
  1. Add the following prompt:
    Get the details from the Message payload
    Forward Conversations Email Prompt Pn
  2. At Output fields, click add field. Give the fields a name and select the field type. Repeat this for all desired data.
    Forward Conversations Email Output Field Pn
  3. Click Generate preview to see the outcome of your prompt and click Finish.
    Forward Conversations Email Preview Pn
9

Set up mail connection

Select your email provider. At Action event, click Send email.In account connect your email adress by logging in at your provider
Forward Conversations Email Connect Email Pn
10

Configure email

Now you are going to configure your email settings.
  1. Add to/from addresses:
    • In the To field, add the email address where the emails should be send to.
    • In the From field, add the email address of the sender. Best is to use an exsisting email address. Otherwise your emails might end up in your Spam folder.
    Forward Conversations Email To From Pn
  2. Add Subject and body
    • For the Subject, choose a subject which makes clear to the receiving party what needs to be done. Example: New chat via Watermelon
    • In the Body field, write the email you want to receive. If you click the plus button, you can add the Output fields from AI by Zapier. Add the Message Payload to include the entire conversation.
      Hi, A new chat came in via Watermelon. Please follow up the request. Name: [Name] Email: [emailaddress] Phonenumber: [phone number] Chat conversation: [message payload]
11

Test step

Click on Continue and test the email step.
12

Publish workflow

When the email is received correctly, you can Publish our workflow by clicking Publish.
Your automation is now completed. You can test your automation in the Chat Widget. The handover functionality and automation do not work in the Playground.