voice

May We Ring This Callback

The softphone's question before it dials a TICKET: is it inside the customer's calling hours right now, and if not, when?

⛔WHY THIS EXISTS, 2026-09-24. Frederick: the out-of-hours pop-up applies to "every ticket dial path that can refuse for hours ... the softphone path currently speaks the refusal and hangs up, so also show the pop-up in the browser." /outbound/from-browser is a Plivo webhook: its answer goes to Plivo as XML, never to the browser, so the browser cannot learn from it why the call died. So the browser asks here first, and gets the SAME verdict -- ringing_back.may_the_desk_ring, the one function /outbound/from-browser and /outbound/cell-bridge both refuse with.

⛔A READ, AND NOT THE GATE. The refusal at the dial stays exactly where it is: a screen's copy of the hour is as old as its last fetch, so /outbound/from-browser still speaks the refusal and hangs up if the hour turned between this answer and the call.

get/api/voice/callbacks/{ticket_id}/may-we-ring

Request

  • Base URL: https://api.pigeonly.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.pigeonly.com/api/voice/callbacks/{ticket_id}/may-we-ring
  • Auth: none declared

Path parameters

ticket_idstring uuid required

Query parameters

phonestring

Response

Successful Response

okboolean required
detailstring nullable
next_allowed_atstring nullable
customer_zonestring nullable

Changes

No recorded changes to this operation across all 1 revision of this API.