Skip to content
DialDozer DialDozer Docs

CTI

CTI endpoints require the cti scope. Dial requests also require the API key to be bound to an agent user.

Look up a phone number

Section titled “Look up a phone number”

GET /hooks/api_v1.php?r=cti/lookup&phone={phone}

Terminal window
curl -G 'https://app.dialdozer.com/hooks/api_v1.php' \
  --data-urlencode 'r=cti/lookup' \
  --data-urlencode 'phone=+1 555 123 4567' \
  -H "X-Api-Key: $DIALDOZER_API_KEY"
{ "ok": true, "found": true, "lead_id": 42, "name": "Alice Johnson" }

For privacy, lookup returns only whether a match exists, the lead ID, and name.

Request a dial

Section titled “Request a dial”

POST /hooks/api_v1.php?r=cti/dial

Terminal window
curl -X POST 'https://app.dialdozer.com/hooks/api_v1.php?r=cti/dial' \
  -H "X-Api-Key: $DIALDOZER_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"phone":"+1 555 123 4567"}'
{ "ok": true, "id": 901, "lead_id": 42 }

A dial is queued for the bound agent; the response does not mean the call connected. Invalid numbers return 422 bad_phone. Unbound keys return 403 no_bound_agent.