The scheduled-calls list

Every booked call — by the agent in a conversation, by the user from your app, by your team in the dashboard — is one list per user. Your app can read it, cancel from it, and book into it with a screen of its own (or let the SDK's sheet do the booking).

What it needs in the dashboard

What to do, in order

1. Read the rules — schedulingRules: whether users may book, the earliest and latest times (earliest(now), latest(now)), how many may wait, the call name. No request: it comes with the agent's settings.
2. Book with a time and an optional reason (120 characters). → The SDK refuses on the device first — scheduling_off, too_soon, too_far — then Graine checks the calling window and the calls already waiting.
3. List the user's calls — upcoming first.
4. Cancel one whose canCancel is true. → Its status becomes cancelled.
5. Follow the status as the time comes: scheduled → ringing → answered → completed, or declined, missed, failed, expired, no_device.

source says who booked it: agent, app (your app), dashboard or api. A status or source newer than your SDK arrives as unknown, carrying its word.

The code, platform by platform

let graine = GraineInApp.shared
let rules = graine.schedulingRules                                    // 1
guard rules.usersCanBook else { return }
let inAnHour = max(rules.earliest(now: Date()), Date().addingTimeInterval(3600))
 
do {
    let call = try await graine.scheduleCall(at: inAnHour, reason: "Talk through my order")   // 2
    let upcoming: [GraineScheduledCall] = try await graine.scheduledCalls()                  // 3
    print(upcoming.map { "\($0.id) \($0.status) \($0.source?.description ?? "")" })
    if call.canCancel {
        let status = try await graine.cancelScheduledCall(id: call.id)                        // 4: .cancelled
        print(status)
    }
} catch let error as GraineServiceError {
    switch error.code {
    case .tooSoon, .tooFar, .outsideWindow: print("Pick another time: \(error.message)")
    case .tooManyPending: print("Cancel one first")
    default: print(error.code, error.message)
    }
}

Troubleshooting

The full rules, holds and webhooks: Scheduled calls · SDK reference → Scheduling.