> ## Documentation Index
> Fetch the complete documentation index at: https://graine.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Campaign Scheduling

> Schedule campaigns with timezone and working hours

## Scheduling Overview

Graine AI provides flexible scheduling options to ensure calls are made at the right time for your audience.

## Schedule Configuration

### Start and End Times

**Start Date/Time**\
When your campaign begins making calls

**End Date/Time**\
When your campaign stops (even if contacts remain)

<Note>All times are converted to your selected timezone</Note>

### Timezone Selection

Choose the appropriate timezone for your audience:

**Common Timezones**:

* **Asia/Kolkata** (UTC+5:30) - India
* **America/New\_York** (UTC-5:00) - Eastern US
* **America/Los\_Angeles** (UTC-8:00) - Pacific US
* **Europe/London** (UTC+0:00) - UK
* **Europe/Paris** (UTC+1:00) - Central Europe
* **Asia/Singapore** (UTC+8:00) - Singapore
* **Australia/Sydney** (UTC+10:00) - Australia

<Warning>
  Always select the timezone of your call recipients, not your location
</Warning>

## Working Hours

Define when calls can be made:

### From Hour

Start of calling window (24-hour format)

* Example: `9` for 9:00 AM
* Example: `14` for 2:00 PM

### To Hour

End of calling window (24-hour format)

* Example: `18` for 6:00 PM
* Example: `21` for 9:00 PM

### Days of Week

Calls are made Monday-Sunday by default. The platform respects your working hours every day.

## Retry Scheduling

### Max Retry Count

How many times to retry failed or unanswered calls

* Default: 5 retries
* Recommended: 3-5 for most use cases
* Higher counts for critical campaigns

### Cooldown Period

Time to wait between retry attempts

* Default: 45 minutes
* Minimum: 30 minutes
* Recommended: 45-60 minutes

<Tip>
  Retries only occur during working hours, never outside your defined window
</Tip>

## Best Practices

<AccordionGroup>
  <Accordion title="Respect Local Time">
    Always set timezone to match your recipients' location, not yours. Calling at 3 AM is never a good idea!
  </Accordion>

  <Accordion title="Avoid Early/Late Hours">
    **Recommended windows**: - B2B: 9:00 AM - 6:00 PM - B2C: 10:00 AM - 8:00 PM -
    Healthcare: 9:00 AM - 5:00 PM - Avoid: Before 9 AM or after 9 PM
  </Accordion>

  <Accordion title="Consider Day of Week">
    **Best days**: - B2B: Tuesday-Thursday - B2C: Any weekday, Saturday mornings -
    Avoid: Mondays (busy), Fridays (distracted), Sunday evenings
  </Accordion>

  <Accordion title="Smart Retry Strategy">
    **For important calls**: 5 retries with 45-min cooldown **For general
    outreach**: 3 retries with 60-min cooldown **For surveys**: 2 retries with
    90-min cooldown
  </Accordion>

  <Accordion title="Account for Holidays">
    Check local holidays before scheduling campaigns. Pause campaigns during major holidays.
  </Accordion>
</AccordionGroup>

## Scheduling Examples

### Business Hours Campaign

```plaintext theme={null}
Timezone: Asia/Kolkata
Start: 2025-01-20 09:00
End: 2025-01-25 18:00
Working Hours: 9:00 - 18:00
Retries: 3 with 60-min cooldown
```

This campaign will:

* Start January 20th at 9 AM IST
* Make calls only between 9 AM - 6 PM IST
* End January 25th at 6 PM IST
* Retry failed calls up to 3 times, waiting 60 minutes between attempts

### Multi-Day Outreach

```plaintext theme={null}
Timezone: America/New_York
Start: 2025-02-01 10:00
End: 2025-02-15 20:00
Working Hours: 10:00 - 20:00
Retries: 5 with 45-min cooldown
```

This campaign will:

* Run for 2 weeks
* Call between 10 AM - 8 PM EST daily
* Retry up to 5 times with 45-minute waits

## Monitoring Schedule Compliance

The platform automatically:

* Pauses calls outside working hours
* Resumes at the next working period
* Tracks scheduled vs actual call times
* Reports on schedule adherence

## Pausing and Resuming

You can manually:

* **Pause**: Stop calls temporarily (schedule continues)
* **Resume**: Restart calls (respects working hours)
* **Stop**: End campaign permanently (cannot resume)

<Note>Paused campaigns will resume at the next working hours window</Note>

## Timezone Conversion

The platform handles timezone conversion automatically:

* Display times in your selected timezone
* Make calls at the correct local time
* Account for daylight saving time changes

## Next Steps

<CardGroup cols={2}>
  <Card title="Create Campaign" icon="plus" href="/campaigns/creating-campaigns">
    Set up your scheduled campaign
  </Card>

  <Card title="Best Practices" icon="star" href="/guides/best-practices">
    Learn campaign optimization tips
  </Card>
</CardGroup>
