Collect Fin Voice call by external ID

Request

Retrieve information about a Fin Voice call using the external call identifier.

Security

bearerAuth

Path

external_idstringrequired

The external call identifier from the call provider

curl -i -X GET \
  'https://api.intercom.io/fin_voice/external_id/{external_id}' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

successful

Bodyapplication/json

idinteger

The unique identifier for the external reference

Example:12345

app_idinteger

The workspace identifier

Example:12345

user_phone_numberstring

Phone number in E.164 format for the call

Example:"+1234567890"

statusstring

Status of the call. Can be "registered", "in-progress", or a resolution state

Example:"registered"

intercom_call_idstring or null

The Intercom call identifier, if the call has been matched

Example:"1234"

external_call_idstring

The external call identifier from the call provider

Example:"call-123-abc"

intercom_conversation_idstring or null

The Intercom conversation identifier, if a conversation has been created

Example:"5678"

call_transcriptArray of objects

Array of transcript entries for the call

Example:

[]

call_summarystring

Summary of the call conversation, truncated to 256 characters. Empty string if no summary available.

Example:"Customer called about billing issue..."

intentArray of objects

Array of intent classifications for the call

Example:

[]

attributesobject

The conversation attributes Fin classified on this call, as attribute name to value. Empty object when the number has no classification attributes configured or none were set.

Example:

{
  "Intent Type": "Sales",
  "Sales Category": "Enterprise Sales"
}

dataobject

The metadata object supplied when the call was registered, returned verbatim. Empty object when none was supplied.

Example:

{
  "masterContactID": "abc123",
  "DNIS": "+18005551212"
}

Response

{
  "id": 12345,
  "app_id": 12345,
  "user_phone_number": "+1234567890",
  "status": "registered",
  "intercom_call_id": "1234",
  "external_call_id": "call-123-abc",
  "intercom_conversation_id": "5678",
  "call_transcript": [],
  "call_summary": "Customer called about billing issue...",
  "intent": [],
  "attributes": {
    "Intent Type": "Sales",
    "Sales Category": "Enterprise Sales"
  },
  "data": {
    "masterContactID": "abc123",
    "DNIS": "+18005551212"
  }
}