Create a voice agent under Agents → Inbound agents. On its Connect tab, give it a phone number, put it on your site, or both. Every call is saved under Communications with a transcript and a summary.

By phone

Give the agent a number you bought in the CRM, under Connect → Telephony. It answers while it’s on.
  • One number answers for one agent.
  • A caller whose number belongs to a contact is filed under that contact.
  • Numbers from a Twilio account you connected yourself can’t be used.

On your site

The call runs in the visitor’s browser. Your server starts it, so your API key stays private. On your server:
Upsert creates the customer if they’re new. Look up finds one you’ve already sent. Saved id is fastest: store contact.id in your own database the first time, and skip the extra call. On the page, from your own button’s click:
  • Start it from a click. Browsers only allow audio after one.
  • Credentials are good for one call. Get new ones on every click.
  • full shows the conversation as it happens; compact shows just the orb.
  • Transcripts arrive word by word: the same id again with more text, until final is true.

Let the script draw the button

It asks your server for credentials on every click, and hides while a call is open.

Your colours

Pass colors to open or init. Every one is optional and takes any CSS colour.

Build your own interface

gdcall.connect({ credentials, onEvent }) runs the call with nothing on screen. It returns mute(true), hangUp() and levels(), which gives { input, output } from 0 to 1 for drawing.