Manage Talkdesk contact records and trigger a Studio outbound IVR flow via the Talkdesk REST API

Steps

1. Obtain an OAuth 2.0 access token via POST to https://api.talkdeskapp.com/oauth/token using client credentials scoped to contacts and flows
2. POST to /contacts with fields (name, phone_numbers, email, external_id) to create or upsert a contact record; use the external_id field to link to your CRM system
3. GET /contacts?phone_number={E164_number} to look up a contact by phone number before initiating a callback to avoid creating duplicates
4. POST to /calls/outbound with the contact phone number, agent or queue target, and an optional flow_id to route the call through a specific Studio flow
5. To trigger a self-service IVR specifically, POST to the Flows API callback endpoint with the customer phone number and the Studio flow ID to initiate an outbound automated call without an agent
6. GET /calls/{callId} after the call ends to retrieve disposition, duration, and the flow path taken for analytics ingestion