allo-call or allo-sms. The call message holds the call details, the AI summary and a link to the recording. The transcript is added as an internal note. A call and the SMS around it stay in the same conversation.
Your Kustomer customers and companies sync to Allo, customer edits included, so callers show up with their Kustomer name and company.
Messages that Allo writes are records only: Kustomer never sends them to your customer by email, SMS or chat.
How to connect
The Kustomer integration connects with a Kustomer API key, your Kustomer address and your region. You need an Allo admin or manager to connect the integration, and a Kustomer admin to create the API key.How to create your Kustomer API key
The API key is a machine user in Kustomer. Every message, conversation and customer Allo writes shows the API key’s name as its author, so name the key Allo.1
Open the API keys
In Kustomer, go to Settings > Security > API Keys and click Add API Key.
2
Name the key
Name the key
Allo. Leave the expiry empty, or set a long one: when the key expires, Allo stops logging calls and SMS.3
Tick the roles
Tick every role listed below.
4
Copy the key
Create the key and copy it. Kustomer shows the key only once. You paste it into Allo in the next step.
org.permission.customer.read,org.permission.customer.createandorg.permission.customer.updateorg.permission.company.readorg.permission.conversation.read,org.permission.conversation.createandorg.permission.conversation.updateorg.permission.message.read,org.permission.message.createandorg.permission.message.updateorg.permission.note.createorg.permission.search.createorg.permission.user.read
.kustomerapp.com in your Kustomer URL. For yourcompany.kustomerapp.com, the address is yourcompany. Allo uses it for the links back to Kustomer.
Your region is where your Kustomer account is hosted: United States, Europe or India. Ask your Kustomer admin if you’re not sure.
Connect in Allo
1
Go to Integrations
In Allo, go to Settings > Integrations.
2
Find Kustomer
Find Kustomer in the Support section and click Connect.
3
Enter your details
Paste the API key in the API key field, enter your Kustomer address in the Kustomer address field, and pick your Region. You can also paste your full Kustomer URL in the address field: Allo keeps only the address.
4
Save and connect
Click Save & Connect.
5
Wait for the contact import
Allo imports your Kustomer customers and companies. The integration shows the import in progress until the first sync finishes.
Choose your support lines (optional)
Support lines decide which Allo lines send calls and SMS to Kustomer. Only calls and SMS on the selected lines are sent. Calls and SMS on any other line are not sent at all, so sales or personal conversations never reach your support team. To send every call and SMS, leave the selection on All lines. To choose support lines, go to Settings > Integrations > Kustomer, open Support lines, select the lines and click Save.For an inbound call or SMS, the line is the number the customer dialed or texted. For an outbound call or SMS, the line is the number shown to the customer. Call back or reply from a support line if you want it logged in Kustomer.
Create unknown callers in Kustomer (optional)
The Create unknown callers in Kustomer setting decides what happens when a caller or SMS sender is not a Kustomer customer yet.- On: Allo creates the caller as a new Kustomer customer and logs the call or SMS on that customer. The new customer is named after the Allo contact, or after the phone number if the Allo contact has no name.
- Off: calls and SMS from numbers that are not Kustomer customers are not sent to Kustomer.
What syncs
From Kustomer to Allo:- Customers that have a phone number, with their name, first email, phone numbers (shared phones included), company, avatar, last activity date and custom attributes
- Companies, with their name, website (from the first domain) and custom attributes
- Calls, logged as voice messages on the matching customer’s timeline, with the transcript as an internal note
- SMS, logged as SMS messages on the matching customer’s timeline
- New customers, when Create unknown callers in Kustomer is on
+14155551234 or 06 12 34 56 78.
How calls are synced
After each call on a support line, Allo adds a voice message to the matching customer’s timeline. The message goes in a new Allo conversation, or in the customer’s recent Allo conversation (see How follow-up calls and SMS are grouped in one conversation). A new conversation has:- The status Open
- The tag
allo-call - A name with the call details, for example
Allo Inbound Call to US Support (+18885550100) - Answered - Leo (2m 03s) - The Kustomer user whose email matches the Allo user’s email as assignee. If no Kustomer user has that email, the conversation is not assigned.
- The call direction and result, the duration, and the from and to numbers with names
- The Allo line and the Allo user who handled the call, and the call tags
- The AI summary
- A link to the call recording
How follow-up calls and SMS are grouped in one conversation
Calls and SMS with the same customer share one conversation. A new call or SMS joins the customer’s Allo conversation when that conversation is Open or Snoozed and was last updated less than 1 hour before it. This covers the customer calling or texting again, and your team calling back or replying. When a call or SMS joins an existing conversation:- Allo adds it as a new message.
- Allo renames the conversation after what it holds:
Allo calls with <customer name> on <line name> (<number>),Allo SMS with …orAllo calls and SMS with …. - Allo adds the
allo-callorallo-smstag if the conversation does not carry it yet. - Allo never changes the status of the conversation.
How SMS are synced
After each SMS sent or received on a support line, Allo adds an SMS message to the matching customer’s timeline, in a new Allo conversation or in the customer’s recent one. A new conversation is Open, carries the tagallo-sms and is named, for example, Allo Inbound SMS to US Support (+18885550100) - Leo.
The SMS message is placed on the timeline at the time the SMS was sent, and contains:
- The SMS direction, and the from and to numbers
- The Allo line and the Allo user who sent or received it
- The message text
Click-to-call
Click-to-call is not available for this integration.Troubleshooting
Check the sync status of any call from the call list on web.withallo.com. Each call has an integration indicator showing its sync state.I cannot connect my integration
I cannot connect my integration
Only admins and managers of an Allo workspace can connect integrations. If you don’t see the option, ask your workspace admin or manager to set it up.If the connection fails, check these causes:
- The API key was copied incompletely. Kustomer shows the key only once. Create a new API key and paste it again.
- The API key expired or was deleted. Create a new API key with every role listed above.
- The address is wrong. Enter only the part before
.kustomerapp.com, for exampleyourcompany.
Call or SMS not synced to Kustomer
Call or SMS not synced to Kustomer
Check these causes, in this order:
- The call or SMS was not on a support line. Only calls and SMS on your selected support lines are sent to Kustomer. Check Settings > Integrations > Kustomer > Support lines, or select All lines to send everything.
- The caller is not a Kustomer customer. With Create unknown callers in Kustomer off, calls and SMS from unknown numbers are not sent. Add the phone number to the Kustomer customer, or turn the setting on.
- A role is missing on the API key. Kustomer refuses requests the key’s roles do not allow. Roles cannot be edited: create a new API key with every role listed above, then disconnect Kustomer in Allo and connect again with the new key.
- The region is wrong. An account hosted in Europe or India must be connected with that region. Disconnect Kustomer in Allo and connect again with the right region.
- Kustomer rate limits. Kustomer limits API calls per minute for the whole account, and searches to 100 per minute for API keys. Rate-limited requests are retried. If the limit is still reached, wait a minute and sync the call again from the call list.
A Kustomer customer does not appear in Allo
A Kustomer customer does not appear in Allo
Check these causes:
- The customer has no phone number in Kustomer. Allo only imports customers with a phone or a shared phone. Add the number in Kustomer; Allo imports the customer at the next hourly sync.
- The sync has not run yet. Allo checks Kustomer every hour. A customer created or changed in Kustomer appears in Allo after the next sync.
- The first import is still running. On a large Kustomer account, the first import can take several minutes.
A follow-up call or SMS opened a new conversation
A follow-up call or SMS opened a new conversation
A follow-up call or SMS joins an existing conversation only when all three conditions are true:
- The conversation was created by Allo and still carries the
allo-callorallo-smstag, or the name Allo gave it. - The conversation is Open or Snoozed, not Done.
- The conversation was last updated less than 1 hour before the new call or SMS.
The conversation is not assigned
The conversation is not assigned
Allo assigns new conversations to the Kustomer user whose email matches the Allo user’s email. If the emails differ, the conversation is not assigned. Use the same email in Allo and Kustomer, or route Allo conversations with a Kustomer business rule on the
allo-call or allo-sms tag.