Auto dialer status changed

Payload telli sends when a contact enters or exits the auto dialer

WEBHOOK auto_dialer_status_changed

Example

{
  "event": "auto_dialer_status_changed",
  "contact": {
    "id": "6bd1e7e0-6d00-4c0b-ad5b-daa72457a27d",
    "external_id": "external-123"
  },
  "auto_dialer": {
    "status": "not_in_dialer",
    "updated_at": "2024-11-18T15:10:02.078Z",
    "reason": "last_call_was_connected"
  }
}

Use this event to track whether telli is still trying to reach a contact. It is the supported replacement for contact_status_changed.

Check the current status

The contact APIs return the current auto-dialer enrollment state, while this webhook reports a change to that state:

Surface	Status field
V2 Contact API	autoDialerStatus
V1 Contact API	auto_dialer_status
This webhook	auto_dialer.status

All three fields use in_dialer and not_in_dialer. The API fields are current snapshots. Webhook events additionally include auto_dialer.updated_at and, when a contact exits the dialer, auto_dialer.reason.

Exit reasons

auto_dialer.reason is present only when auto_dialer.status is not_in_dialer:

Reason	Meaning
last_call_was_connected	The last call connected, so no further attempts are needed
scheduler_gave_up_interval	The interval dialing plan ran out of attempts
scheduler_gave_up_smart	The smart dialing plan reached its stop condition
call_transferred	The inbound callback was transferred
manually_removed_from_dialer	Someone removed the contact from the dialer
no_next_opportunity	No valid future time to call was found
sip_error	The phone network returned an error we do not retry
call_failed	The call still failed after an automatic retry
dialing_unavailable	The contact, account, outbound number, or auto dialer is no longer available

last_call_was_connected and call_transferred are success cases; the rest mean telli stopped without reaching the contact.

When an inbound callback is forwarded, telli completes the active dialing loop for the same contact and agent, including a newly scheduled loop. Its pending outbound call is removed. The contact’s next-call time is recalculated from any remaining unfinished loops. Use the auto-dialer status to determine whether the contact is still enrolled; a next-call timestamp alone does not confirm enrollment.

See Auto dialer for how dialing plans decide when to stop.

Body

application/json

event · string · required

Always auto_dialer_status_changed.

Allowed value: "auto_dialer_status_changed"

contact · object · required

Show child attributes

auto_dialer · object · required

Whether the contact is now in the auto dialer, and — when they exited — why.

Option 1

Option 2

Show child attributes

Response

2XX

Acknowledged. Return any 2xx within 15 seconds or the message is retried.