What you’ll need
- A Zendesk account
- Your Zendesk address, for example
company.zendesk.com - A Zendesk user who is allowed to give apps access
Connecting Zendesk to Verbu
- Open the agent and click Integrations at the bottom of the menu.
- Click Zendesk in the list.
- Click Connect.
- Type your Zendesk address. Only the first part: if the address bar says
company.zendesk.com, you typecompany. - Sign in to Zendesk and approve the access.
- Verbu asks whether you want the standard setup. Click Use the standard setup. You can change each item later.
- Click Publish in the agent’s menu.
The standard setup
By default the agent creates the ticket after the conversation, not during it. So each conversation gets one ticket.
If you click I will add them myself, we add nothing. You then add each tool yourself, as described below.
The Zendesk page
The top of the page shows whether the connection works:- Working (green): everything is in order.
- Needs a look (amber): Zendesk refused an access. The page tells you what to do.
- ⟳ loads groups and other lists from Zendesk again. Use it after you create a new group in Zendesk.
- Remove integration disconnects. See Remove the integration.
General settings
Click General settings to open the section. It applies to every ticket the agent creates, both during and after the conversation.Before the conversation
Load the user’s open tickets. The agent looks the user up by phone number and reads their name and open tickets. So the conversation starts with the agent knowing what is already going on. Turn it on and off with the switch.During the conversation
These are the tools the agent can use while it talks to the user:- Look up a ticket. The agent reads the status and the latest reply on one of the user’s own tickets.
- Add a note to a ticket. The agent adds an internal note to one of the user’s own tickets. Only your team sees it.
- Create a ticket during the conversation. The agent creates a ticket while it talks to the user.
What the agent may do on each channel
For each tool you choose what the agent may do on the phone and on chat. Chat also covers web calls and e-mail.
By default the phone is set to Yes and chat to Ask. On chat the agent asks for the user’s phone number or e-mail and sends the code there. The agent can only see and write on tickets where the user is the requester.
Create a ticket during the conversation needs no code, because it reads no existing tickets.
The choice belongs to the connection. If several agents use the same connection, it applies to all of them.
After the conversation
Create a ticket in Zendesk. The agent creates one ticket with the summary, the outcome and the details it collected. The ticket also links back to the conversation in Verbu. If it says Not added to the agent, click Add. Once it is added, turn it on and off with the switch.When a ticket is created
By default the agent creates a ticket only when the conversation ends like this:- Handed to a person
- Ready for follow-up
- Asked for a person
If you also create tickets during the conversation
If both Create a ticket during the conversation and Create a ticket in Zendesk are on, the conversation still gets only one ticket. The ticket from the conversation is used, and no new one is created afterwards.The tools on the agent
The same tools also show under Train → Tools and under Deploy → Automations. They are the same tools, so a change in one place also shows in the other. Under Tools you can write when the agent must use a tool. Click the tool and fill in When should the agent use it?. For example “When the user asks about the status of a ticket”. If you leave it empty, the agent decides for itself.Users we do not know yet
The agent looks for the user by phone number and e-mail. If they are not in Zendesk, we create the user, so the ticket has a requester and the next conversation can find them again. You control this with Add the user to Zendesk when they are new. If you turn it off, the ticket is still created, but without a user on it.Times
Zendesk stores times in UTC. The agent says times in your own time zone, the one under Settings → General. If a ticket was updated at 19:56 Danish time, the agent says 19:56.Teach the agent with your help articles
Your Zendesk Help Center articles and your macros can teach the agent, so it answers in your own words.- Open the agent and click Content.
- Click Add a source and pick Zendesk under System.
- Under What to learn, choose what the agent may read. All of it is recommended.
- Save.
Where you see it afterwards
In the Inbox. Open a conversation and the panel on the right leads with a Zendesk section holding Ticket # and Zendesk user. Both open Zendesk in a new tab. When there is no ticket yet it says Create ticket instead, so you can create one yourself. In Contacts. The people the agent looked up get a link to their Zendesk profile and a list of their open tickets. Under Activity. The Activity tab on the Zendesk page shows every call to Zendesk, and whether it worked.How it sounds in a conversation
User: Hi, I’m calling about my order. Agent: Hello Mette. I can see you have a ticket about a delayed delivery. Is that what this is about? User: Yes. Has anything happened? Agent: It was last updated yesterday at 14:10. Your team wrote that the parcel has been sent again. Shall I add a note that you are still waiting? User: Yes, please. Agent: Done. The team can see your note on the ticket.The agent knew who was calling because it read the user’s tickets before answering. During the conversation it looked up the ticket and added a note to it.
If something goes wrong
It says the user is not known in Zendesk
It says the user is not known in Zendesk
It means nobody in Zendesk matches the number or the e-mail we hold. That is normal the first time somebody gets in touch. If Add the user to Zendesk when they are new is on, they are created along with the ticket.
No ticket is created
No ticket is created
Check three things. That Create a ticket in Zendesk is added and on. That you clicked Publish afterwards. And that the conversation’s outcome matches what you chose under Choose which conversations. You can see the outcome on the conversation in the Inbox.
The agent does not use a tool during the conversation
The agent does not use a tool during the conversation
Check that the tool does not say Not added to the agent, and that you clicked Publish. Also check that the channel is not set to No. If it is set to Ask, the agent uses the tool only after the user has given the code.
The ticket lands in the wrong group
The ticket lands in the wrong group
Open General settings and change Put the ticket in this group. If the group is new in Zendesk, click ⟳ at the top of the page first, so we load the groups again.
It says the connection has to be made again
It says the connection has to be made again
Zendesk has withdrawn the access. Click Connect again and sign in. Your tickets in Zendesk are untouched.
I get an error when I type my Zendesk address
I get an error when I type my Zendesk address
Type only the first part. If it says
company.zendesk.com, you type company, without https:// and without a slash.Remove the integration
Click Remove integration at the top of the page and confirm. Verbu forgets the access and stops calling Zendesk. The agent’s Zendesk tools and automations are removed. Your tickets and users in Zendesk are untouched. If the agent learned from your Zendesk articles, we also ask what to do with that content:- Leave the box empty and the agent keeps what it learned. It is no longer updated, because we cannot read from Zendesk without the connection.
- Tick the box and we remove the content, so the agent no longer answers from it.
Next steps
- Talk to the agent under Test → Live test
- See the outcome of every conversation under Conversations
- Add more in Knowledge and training