FAQ: cutting the campaign by the current time and the working window
Which hour checks the adapter performs
Which hour checks the adapter performs
First come the four V2 checks by hour — minutes are ignored. The window is the adapter account window; the current hour is in the organization’s time zone.
Then hours with minutes are calculated: end =
ending_hour:ending_minute (24 means 23:59), and it is cut to the earlier of the adapter account window end and the organization’s calling window end. When the end is cut, the client gets the key "notice":"End time 21:30 is out of eligible range, cut to 21:00" in the response. If the start (the specified one or the adapter account’s start hour) is not earlier than the cut end, the client gets the text of check 3.The client sees a notice key in the response. Is it an error?
The client sees a notice key in the response. Is it an error?
No. The request is accepted and the campaign is created; only the end is shortened to the window. This is the only key beyond the V2 templates; a client that parses JSON by key will skip it. If the client compares the whole response body, it needs to send an end inside the window.
The request went to tomorrow, although the client expected calls today
The request went to tomorrow, although the client expected calls today
The «campaign day» rule: if 5 minutes or less remain until the end of the campaign day, or it has already passed, the campaign is created for the next day with the same hours. The end of the campaign day is the earliest of the organization window end, the adapter account window end, and the request end after the cut. The V2 rule «from 19:56 to tomorrow» was not carried over. Check the date in the campaign name and
rl_today.Every repeat of the request gets «Internal error», and the campaign is cancelled at once
Every repeat of the request gets «Internal error», and the campaign is cancelled at once
Probable cause: the organization’s calling window was narrowed after the adapter account was set up, and the request start became earlier than the start of the organization window. The cut shortens only the end, and the platform rejects a start that is too early.What to do: narrow the adapter account window in the edit window (the cabinet shows the organization window) and ask the client to send a start inside the window. Engineers will confirm the exact cause in the logs.
The client sent an end of 21:30, but the campaign shows 21:00. Are the minutes lost?
The client sent an end of 21:30, but the campaign shows 21:00. Are the minutes lost?
Yes: the end is cut to the adapter account window end of 21:00, and the minutes of the window’s last hour are lost. If minutes matter to the client, the adapter account window must end later.