​

Intercom: peer-to-peer auto-answer

​

Paging groups (many) vs intercom (one)

​

Dial an extension

​

Auto-answer semantics — user target vs SIP target

• user_id — an in-app auto-answer invite is pushed to that user’s softphone widget. The invite carries a deep link with autoAnswer=1 and the mode, so the widget accepts the call on speaker instead of showing a ringing UI. This is the right kind when you address coworkers by their user id.
• sip_username — the target is resolved against your organization’s registered SIP credentials and rung directly on its device Contact binding with a SIP INVITE carrying the hands-free auto-answer headers (below). SIP usernames are checked per organization — a deskphone or registered softphone is reached by its SIP username, no user id mapping required.

​

Hands-free headers vs ring-style

• Call-Info: ...;answer-after=0 — honoured by Cisco, Grandstream, Snom, Yealink (the answer-after convention).
• Alert-Info: info=alert-autoanswer;delay=0 — honoured by Polycom, Aastra, Mitel devices.

​

Response

​

Error cases

• 400 — body failed validation (unknown target kind, a mode outside two_way/ptt, or extra fields — the schema is strict).
• 400 — you intercommed your own user id (user_id target only).
• 404 — for a sip_username target, no enabled, non-deleted credential with that username exists in your organization. The check is org-scoped: another organization’s credentials are invisible to you.

​

Example

curl -X POST https://api.orbit.devotel.io/api/v1/voice/intercom/dial \
  -H "Authorization: Bearer $SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "target": { "kind": "sip_username", "value": "desk-101" },
    "mode": "ptt",
    "message": "Front desk, line one for you."
  }'

{
  "data": {
    "intercomCallId": "intercomCall_01J...",
    "mode": "ptt",
    "target": { "kind": "sip_username", "value": "desk-101" },
    "targetResolved": true,
    "notified": false,
    "sipTargetNotMapped": false,
    "sipOriginated": true,
    "sipCallSid": "CA2ea5e1..."
  }
}