Skip to content

İYS and pre-checks

Every outbound call request is checked in two stages: on submit (when the request is opened; cheap checks) and right before dialling (İYS consent). A request that fails a check becomes reddedildi (rejected) and carries the reason in sebep. The API and button also return rejections with 201; the request record is kept as an audit trail.

In order:

#CheckRejection reason
1Purpose exists and is active (outbound calls on in your plan; carts too for commercial purposes)422 unknown_purpose (no record)
2Phone is a valid Turkish number422 invalid_phone (no record)
3Plan limit: daily and monthly outbound calls422 limit_asildi (no record)
4For a purpose with a required İYS check, a consent provider is configurediys_saglayici_yok
5Company-wide daily quotafirma_kotasi_asildi
6The triggering person’s daily quotakota_asildi
7An open request for the same number + purposeacik_istek_var
8The number is on the do-not-call listarama_yasagi
9The number was completed for this purpose in the last N daystekrar_korumasi
10Calling hours: no open day at allarama_saati_yok

A request that passes is sirada if within calling hours, otherwise planlandi for the next opening (sebep: arama_saati_disi; with en_erken, sebep: en_erken).

If the purpose requires the İYS check, the scheduler asks your consent provider for CALL consent right before dialling:

AnswerResult
ONAY (consent)Called
RET (refused) or unknownreddedildi, iys_izin_yok
Provider unreachableRetried after 30 min (planlandi, iys_erisilemedi); rejected on the 3rd try

As a last line of defence, a call that needs the İYS check is started only on ONAY. If the customer says “don’t call me” during the call, the number is added to the do-not-call list; if your consent provider supports it, a RET is reported to it. İYS integration →

Settings → Outbound calling (plan: Outbound calls):

SettingDefaultLimit
Calling hours (Istanbul time)Weekdays 09:00–20:00, Saturday 10:00–18:00, Sunday closedOne range per day or closed
Daily quota per person501–1000
Company-wide daily quota (console, API and button)2001–100000
Repeat protection7 days1–90
Simultaneous outbound calls21–20
Retries on no answer or busy20–5
Retry interval120 min15–1440
If the customer objects to recordingContinue without recordingContinue without recording / End politely
Abandoned cart threshold120 min15–10080
Cart and customer record retention180 days7–3650 (plan maximum)
Coupon email retention365 days30–3650 (plan maximum)

If all days are closed, new outbound calls are rejected with arama_saati_yok. Quotas count by Istanbul calendar day; requests rejected because of a quota don’t count towards it.

  • Numbers on the list are never called for any purpose, test calls included.
  • Numbers are not stored in plain text: a company-specific, irreversible HMAC hash is kept. That is why the list is not shown in the console; only the count is.
  • Use Add to list / Remove from list for individual numbers. When a customer says “don’t call me” during a call, the number is added automatically.