Cannon VoIP Help

Connect ServiceNow

What connecting ServiceNow does, from caller names to calls logged back, and how to get its details and connect it.

Updated yesterday

ServiceNow is the service desk and IT workflow platform. This article explains what connecting it does and how to connect it.

What it does

Your ServiceNow contacts are copied into your company contacts, so a caller ServiceNow knows shows by name on every desk phone and app before anyone picks up, and in your call history afterwards.

With call logging on, every finished call is filed in ServiceNow on the matching record: who took it, how long it lasted, missed calls and voicemails, and the call summary. You can log texts too (one note per conversation once it goes quiet for half an hour), and add a link to the call in the portal. When ServiceNow doesn't know the caller, you choose to skip the call.

Contacts sync every 15 minutes (only what changed), with a full sync each day that also removes contacts deleted there.

Before you start

  • Plan: any ServiceNow plan with API access.
  • Who: A ServiceNow admin (the admin role) makes the user, and the OAuth client if you need one.
  • On our side: a company administrator connects it, once, for the whole company.

Get your details from ServiceNow

  1. In ServiceNow, go to User Administration > Users and click New.
  2. Make a user just for this: User ID cannon.voip, first name Cannon, last name VoIP. Tick Web service access only so it can't sign in to the website.
  3. Save, then set a password for it with Set Password, and copy it.
  4. On the user's Roles tab, add itil. It lets the user read your users and make incidents. If your instance is locked down further, give it read on sys_user (or customer_contact) and create on incident instead.
  5. Only if your instance turns basic sign-in off for web services: go to System OAuth > Application Registry > New > Create an OAuth API endpoint for external clients, name it Cannon VoIP, save, and copy the Client ID and Client Secret.
  6. In Cannon VoIP, open Integrations, pick ServiceNow and fill in the form.

Connect it

  1. In the portal, go to Contacts and click Connect a CRM (or Connect another CRM). You can also start from Company > Integrations.
  2. Choose ServiceNow and fill in:
  3. - ServiceNow address (https://company.service-now.com): the address you sign in to ServiceNow at - Integration user's user ID: step 2 - Integration user's password: step 3 - OAuth client ID (optional) (optional): step 5, only if you made one - OAuth client secret (optional) (optional): step 5 - Whose numbers to match: sys_user or customer_contact (optional) (optional): leave empty for your users (employees); customer_contact if you run Customer Service Management and your callers are customers - Resolution code for logged calls (optional) (optional): leave empty for Solution provided; otherwise one of your instance's resolution codes

  4. Click Connect & sync. The first sync runs straight away and says how many contacts came across.
  5. To file calls in ServiceNow, tick Log finished calls into ServiceNow on the connection, and choose what happens when ServiceNow doesn't know the caller.

If it says Needs attention

The connection's card on Company > Integrations shows the last error. The usual causes:

  • The key was reset, expired or deleted in ServiceNow: make a new one and connect again with it.
  • The person who made the key lost access or left: make the key as someone who is staying.
  • Each call and text conversation becomes a Phone incident on the caller, resolved straight away so it doesn't land in anyone's queue. If a business rule stops incidents being resolved that way, they're left open instead.
  • No ServiceNow Store app is needed. Everything runs on your instance's own REST API with the user you made.

Press Sync now on the connection to try again straight away. To stop, press Disconnect: contacts already copied stay in your contacts, and calls already logged stay in ServiceNow.

Was this helpful?
← All help articles