Emotive

Updated 2 weeks ago by philippe Roireau

Emotive is an SMS marketing platform for Shopify merchants.

How it works

The goal of the integration is to allow you to manage all of your Emotive conversations right from within Gorgias. Here's what the integration will allow once set up: 

• New conversations that happen in Emotive create tickets in Gorgias
• All customer responses from Emotive are added to the same open tickets in Gorgias
• Conversations that Emotive starts with customers will sync to provide context for where the conversation was handed off to Gorgias
• Responding to a ticket in Gorgias sends a message via Emotive to the customer
• Closing a ticket in Gorgias closes a conversation in Emotive
• When Emotive learns the customer's name from an order or an abandoned checkout, it'll update the user profile in Gorgias with their first and last name on the next ticket that is opened
• You'll also be able to send images to customers via Gorgias
• You can also opt-out a customer using Gorgias commands

Setup instructions

You will first need to set up the integration in Emotive and then add the webhook to Gorgias.

Changes to be made in the Emotive dashboard:

Go to Settings -> Integrations -> Gorias

Gorgias API Key – Get this key from your Gorgias Account at the REST API tab

Email Address – The email address associated with the account

Base Gorgias URL – If you access Gorgias at https://emotive.gorgias.io/, then simply enter “emotive”.

Note: Please make sure that there are no spaces in the Base Gorgias URL or any other of these API inputs.

As for the Gorgias side of things:

You'll want to create two webhooks. The first one is the Ticket Message Created Webhook. This webhook lets Emotive know when a new ticket message (ie. a response to a customer) is added to a ticket.

1. From your Gorgias account, go to Settings > Integrations > HTTP Integrations, as shown on the screenshots below:

1. Add a new integration with the following parameters:

It is very important to set the integration name as 'Emotive Integration' due to Emotive's backend, but the description is totally up to you. As for the URL, you'll want to use this one:

https://webhooks.emotiveapp.co/api/gorgias/webhook

1. Add the following JSON template:

    {
       "message_html": "{{message.body_html}}",
       "ticketId": "{{ticket.id}}",
       "brand": "{{ticket.meta.baseUrl}}",
       "message_status": "{{ticket.status}}",
       "subject": "{{ticket.subject}}",
       "message_sent": "{{message}}",
       "from_agent": "{{message.from_agent}}",
       "internal_note": "{{message.public}}",
       "message_attachments": "{{message.attachments}}",
       "message_body": "{{message.stripped_text}}"
   }

And that's it, you're ready to hit 'Save'! Now, for the Ticket Updated Webhook:

• Create another HTTP Integration with the following parameters:

Name – Emotive Webhook

Trigger – Ticket Updated ** (important, make sure that this is Ticket Updated) **

URL – https://www.emotiveapp.co/api/gorgias/webhook

HTTP Method – POST

Request/Response Content-Type – application/json

Request Body (JSON) – paste the content below:

{  
   "message_sent":"",
   "brand":"{{ticket.meta.baseUrl}}",
   "ticketId":"{{ticket.id}}",
   "message_status":"{{ticket.status}}",
   "subject":"{{ticket.subject}}"
}

In the end, your dashboard should look something like this:

FAQs

How do I opt-out a customer?

You can reply to an Emotive ticket with #optout or #opt-out to opt-out a customer from a mailing list directly from Gorgias.

What does "Auto-Create Tickets" mean?

This option creates a new Gorgias ticket for every customer that replies to your Emotive number. Disabling this option allows you to manually choose which responses get created as Gorgias tickets via the Emotive response interface.

Can I create SMS tickets from Gorgias?

Unfortunately, customers must first text your Emotive number to start an SMS Gorgias ticket. You cannot start an SMS conversation with a customer from Gorgias.

How do I filter Emotive tickets in Gorgias?

Tickets coming from Emotive will not be automatically tagged. For easier filtering and conversation management in Gorgias, we recommend setting up an auto-tag rule like indicated on the screenshot below:

You can then use the tag 'Emotive' to set up a dedicated ticket view:

The email thread and signatures are being added to each SMS message sent from Gorgias. How do I turn that off?

Go to your HTTP Emotive Integration settings and update body_text to stripped_text . Stripped text is defined as the text version of the body of the message without email signatures and previous replies.

How did we do?