Avochato for Salesforce – Field Syncing
Sync custom field data between Avochato and Salesforce.
Avochato ⇒ Salesforce custom fields sync
You can sync any Avochato custom field data into Salesforce custom fields, and vise versa, using Avochato custom fields.
Import custom fields based on Salesforce schema
Already have rich custom fields within Salesforce that you’d like to import into Avochato custom fields? Follow this help article to see how to copy over your Salesforce custom fields into Avochato.
Manually create Avochato Custom Fields
Go into Avochato → Settings → Custom Fields to see a list of your Avochato custom fields, as well as to add new custom fields.
Once an Avochato custom field has been created, select the checkbox to sync the data over to the Salesforce record, and specify the exact Salesforce custom field API name to sync to:
Once this link is established, that Avochato data will sync over to the Salesforce record. You can set up as many custom field connection as you like!
Custom Field Sync Behavior
You can choose on a field by field basis how the Avochato <> Salesforce sync should behave, whether you’d like a bidirectional two-way sync between the platforms, or to have only one-way data transfer for a particular field. Read here to see all your options and how to adjust the settings.
Packaged field syncing
Avochato for Salesforce provides several fields as part of the package that automatically sync data from Avochato to Salesforce. The Avochato permission sets already setup field-level visibility so that Avo4SF users in Salesforce should be able to see the synced data.
Task Field Syncing
We sync several pieces of data to the SFDC Task activity anytime messages, calls, or conversations are transcribed. The data synced over is aligned with the data you would expect from the Avochato API - Send Message API endpoint.
Below is a list of the data synced over to Avochato generated task activities:
Name | API Name | Type | Description |
Avochato Broadcast Id | Avochato__Broadcast_Id__c | Text(20) | The broadcast this activity was sent on behalf of.
(Only populates if it was part of a broadcast) |
Avochato Channel | Avochato__Channel__c | Text(20) | The channel where the activity took place
(SMS, WhatsApp, Live Chat, etc) |
Avochato Contact Id | Avochato__Contact_Id__c | Text(40) | The Avochato Contact that's associated this activity |
Avochato Direction | Avochato__Direction__c | Text(20) | The inbound or outbound direction the activity |
Avochato Element Id | Avochato__Element_Id__c | Text(40) | The Avochato Ticket/Event Id that generated this activity |
Avochato Element Type | Avochato__Element_Type__c | Text(40) | The type of this Avochato activity
(Ticket, SmsMessage, etc) |
Avochato From | Avochato__From__c | Text(40) | The phone number this activity was sent from |
Avochato Origin | Avochato__Origin__c | Text(80) | The Origin of this activity
(API, Broadcast, SMS, Slack, etc) |
Avochato Sent At | Avochato__Sent_At__c | Datetime | The timestamp of the exact time this activity was sent |
Avochato Sent By | Avochato__Sent_By__c | Text(120) | Represents who sent this activity |
Avochato Convo Status | Avochato__Status__c | Text(30) | Represents the status on the Avochato conversation when the activity happened (New, Open, Pending, Closed) |
Avochato Subdomain | Avochato__Subdomain__c | Text(255) | The Avochato Account/Inbox that generated this activity |
Avochato Tags | Avochato__Tags__c | Text(255) | Tags synced over from the Avochato conversation
(Only synced on SFDC Case Conversation Transcriptions) |
Avochato To | Avochato__To__c | Text(40) | The destination phone number this activity was sent to |
SFDC Standard Object Field Syncing
Below is a list of all the fields provided in the standard Avochato for Salesforce data sync, listed in the format Field Label (Field API Name) - Field Type
:
Contact
SMS Opt Out (Avochato__SMS_Opt_Out__c) – Checkbox
Avochato Tags (Avochato__Tags__c) – Text
Avochato Conversation URL (Avochato__Conversation_URL__c) - URL
Avochato Convo Status (Avochato__Status__c) - Text
Avochato Contact Id (Avochato__Contact_Id__c) - Text
Avochato Subdomain (Avochato__Subdomain__c) - Text
Created by Avochato (Avochato__Created_by_Avochato__c) - Checkbox
Lead
SMS Opt Out (Avochato__SMS_Opt_Out__c) – Checkbox
Avochato Tags (Avochato__Tags__c) – Text
Avochato Conversation URL (Avochato__Conversation_URL__c) - URL
Avochato Convo Status (Avochato__Status__c) - Text
Avochato Contact Id (Avochato__Contact_Id__c) - Text
Avochato Subdomain (Avochato__Subdomain__c) - Text
Created by Avochato (Avochato__Created_by_Avochato__c) - Checkbox
Case
Avochato Convo Status (Avochato__Status__c) - Text
Avochato Tags (Avochato__Tags__c) – Text
Avochato Ticket Id (Avochato__Ticket_Id__c) – Text
1. SMS Opt Out
Anytime an Avochato Contact has opted out of SMS communications (whether via a “STOP” reply or manually marked within the Avochato contact), that is synced over to the Contact/Lead’s SMS Opt Out field.
There is also an option in the data sync settings to sync the opt out to a custom field in your Salesforce org:
2. Avochato Tags
Avochato contacts can be marked with relevant tags to help categorize the nature of the contact or conversation. Those tags automatically sync over to the associated Salesforce Lead, Contact or Case, as per your Salesforce Settings preferences in Avochato.
If you’re syncing Avochato to a Salesforce object other than a Lead, Contact or Case, whether it is a standard or custom object, you can create your own custom field called Avochato_Tags__c
on the custom object, and that tag data will sync over as expected! See the Custom field syncing section for instructions on how to create this field.
3. Avochato Ticket Id
When using the Sync to Salesforce Cases setting, this Avochato Ticket Id field tracks which Avochato conversation is associated with the current case. This is tracked in the background to ensure the Avo4SF component brings up the correct Avochato conversation when viewing a Salesforce case
4. Avochato Conversation URL
A simple link to the Avochato conversation, and can be used as a unique identifier for the conversation that it’s associated with.
5. Avochato Convo Status
Every Avochato conversation has a status associated with it, with one of the following statuses: New; Open; Pending; Closed. This can be useful within Salesforce to keep track of what cases / contacts still have open Avochato conversations, and can be used to trigger Salesforce automation (like a notification reminder to your internal users when a conversation stays open for more than 24 hours, etc).
6. Avochato Subdomain
Also known as the Avochato Account or Avochato Inbox, the Avochato Subdomain stores the inbox that the conversation is associated with. This is particularly helpful when you have multiple inboxes in use across your team, and being able to identify which inbox this conversation came from.
7. Avochato Contact ID
This represents the Avochato Contact Id, which can be used to query and update the Avochato Contact using the Avochato API.
8. Created by Avochato
This is a checkbox that is automatically marked true anytime the Avo4SF integration is responsible for creating the SF record.
For custom objects, you can create your own Created_by_Avochato__c
checkbox field to automatically capture this information
Case Device Field Syncing
If you use live chat, and have enabled the Service Cloud integration to automatically create Salesforce cases with every new conversation, the device data is saved to the Salesforce Case.
See the table below for all the device fields supported on Salesforce Cases.
Field API Name | Label | Type | Description |
Avochato__Browser_Version__c | Avochato Browser Version | string (40) | Info based on the live chat device |
Avochato__Browser__c | Avochato Browser | string (60) | Info based on the live chat device |
Avochato__Device_Type__c | Avochato Device Type | string (40) | Info based on the live chat device |
Avochato__Device__c | Avochato Device | string (60) | Info based on the live chat device |
Avochato__IP__c | Avochato IP | string (40) | Info based on the live chat device |
Avochato__OS_Version__c | Avochato OS Version | string (40) | Info based on the live chat device |
Avochato__OS__c | Avochato OS | string (20) | Info based on the live chat device |
Avochato__Ticket_Id__c | Avochato Ticket Id | string (120) | Unique identifier for Avochato live chat conversations |
Avochato__Widget_Dropdown__c | Avochato Widget Dropdown | string (40) | The answer given to the live chat widget dropdown question |
Avochato__Widget_Referral_URL__c | Avochato Widget Referral URL | url | The full URL of the page where this live chat started. Includes URL parameters. |
Check out our Avo4SF device field package if you’d like to add the same device fields to Salesforce Leads and Contacts.
Additional Custom Field Syncing
Whichever object that Avochato syncs record to in Salesforce, you can add a few other custom fields to Salesforce in order to capture more information about the particular Avochato conversation & contact, like the Avochato account / inbox that had the most recent conversation, the Avochato Contact Id, and the URL link to the Avochato conversation.
To get started, first check your Avochato Salesforce settings in the Object Type section, which will specify the Salesforce object sync settings.
When “Default” is selected, it syncs to Salesforce Contacts and Leads, matching by phone number, but you may sync data and activities directly to an Account, Opportunity, or any other Salesforce object. See more advanced setup details in this Data Syncing & Custom Object Support article.
Within Salesforce, go to Setup → Object Manager and select that Salesforce Object Avochato is syncing to.
Below are the supported custom fields you can sync data over to:
- Avochato (Avochato__c) – URL
- Avochato Subdomain (Avochato_Subdomain__c) – Text(80)
- Avochato Contact Id (Avochato_Contact_Id__c) – Text(20)
- Avochato Tags (Avochato_Tags__c) – Text(255), or Long Text Area if you need to save a long list of tags
- Created by Avochato (Created_by_Avochato__c) - Checkbox
Create them with the field API name specified in parentheses and make sure they are visible to the appropriate SFDC profiles, and then they just work!
If you’re new to creating Salesforce custom fields, watch this video from Salesforce to see a nice tutorial from start to finish.
AvoAI Sentiment & Summary Sync
If you’ve enabled AI capabilities within Avochato, called AvoAI, there are several AI generated data points that can sync to Salesforce. See the table below to see what fields and data are available for syncing:
All the fields below are supposed on the following SObjects: Lead, Contact, Case, Task
Name | API Name | Type | Description |
Avochato Rating | Avochato__Rating__c | Number(3,0) | The sentiment rating associated with the conversation, between 1 and 10 |
Avochato Sentiment Summary | Avochato__Sentiment_Summary__c | Text(255) | A quick highlight of what happened in the recent Avochato conversation |
Avochato Actions | Avochato__Actions__c | Text(40) | The recommended next step actions detected by the sentiment analysis |
Avochato Convo Summary* | Avochato__Summary__c | Long Text(3000) | The full recap of the recent Avochato conversation |
*Note: To generate the full ticket summaries, you must enable AvoAI Summaries within the Avochato → Integrations → Salesforce Settings.