Migrating to new chat integration
Benefits of the new chat integration
All newly features such as recently, support for hyperlinks and text formatting, are only accessible in the new chat.
As of today, the main benefits of the chat integration includes:
- New integration is much lighter (code package weight was cut by half) which will improve loading time & chat sending time.
- ADA compliance WCAG which is a legal requirement for all companies providing a chat service (functionalities are available, Gorgias is currently going a validation audit).
- Location of the customer which is available in the same place as the other customer information such as email, phone, etc in the activity sidebar on the left of the screen.
- Additional text formatting (bold, italic, underline, images, GIFs & emojis) and support for hyperlinks.
Migrate previous chat settings
It might be best to go forward with the migration to the new chat at the end of your shift, once you've closed all of your chats for the day.
This is simply because, if you have an ongoing chat ticket started using the old integration, you won't be able to continue the same thread once you've migrated to the new chat integration. If you migrate and go back to that same ticket, you'll get an error when you try to reply to the customer and you'll have to start a new ticket.
Now, if you have to migrate in the middle of some already ongoing chat tickets after all, please remember to make the email capture mandatory. That way, if the ticket comes up with an error due to the migration, you'll still be able to get back to your customer via email.
- Migrate to the old chat integration settings by accessing your current chat integrations configuration page and navigate to the Migrate tab
- Click on Migrate, this will automatically redirect you to a newly created Chat integration (using the new chat) with the exact same configuration settings. Go back to the old chat integration settings.
- In the old chat integration settings, go to the Installation tab and uninstall the old chat integration. (Find the new chat installation instructions in the section below 👇).
Even if the chat is uninstalled, we recommend to not disable the old chat until you've closed all open conversation with this old chat. When the integration is uninstalled but enabled, you can still send messages in the ticket. We recommend moving the chat conversations to an email thread as messages won't be able to be sent via the old chat integration anymore.
- Disable the old chat integration from the integration's page.
- Delete the old chat integration.
New chat set up instructions
- Uninstall old chat integration
Access Settings of your Gorgias account > Integrations > Chat [DEPCRECATED] and disable the old integration. This will prevent any new ticket from coming in Gorgias.Note that you also need to make sure that the old chat widget is removed from your site. Enter the chat's configuration page, go to Installation and deactivate the widget. If you've used a custom script to install the chat, make sure to get in touch with the person in charge of configuring your online store.
- Find the new chat in the integrations list (Settings > Integrations > Chat) and activate the newly created chat.
- Check that your views & rules are updated accordingly
Please note that if you are using any rules or/and views associated with a specific chat integration that was migrated, those would need to be updated as well. Note that the
channel filter is different from
integration as both chat (old and new) are considered a
- If the conditional statement is
if channel is chat, no action is needed
- If the conditional statement
if integration is X(x being your old integration), then replace it with the new integration's name so that it becomes
if integration is Y(y being the new integration)
Example integration filter for rules:
Example integration filter for views:
- Enable & install the chat integration
Note that a common pitfall for this migration is to have both chat active at the same time without noticing it. This might happen if you've installed the chat using a custom procedure. What we recommend is checking with your Online Store administrator to make sure there are no duplicates.
Congrats! Your new chat integration is set!