res_parking

Since 12.0.0 Module Configuration Found this useful? Upvote it. ×

Last reviewed 2026-08-22

Description

res_parking.conf

[globals]

Options that apply to every parking lot

  • parkeddynamic - Enables dynamically created parkinglots.
[parking_lot]

Defined parking lots for res_parking to use to park calls on

  • context - The name of the contextA named section of the dialplan that groups extensions. Calls enter a specific context and can only reach extensions visible from it, making contexts the basic unit of call routing and security. where calls are parked and picked up from.
  • parkext - ExtensionA dialplan entry that matches a dialed number or pattern within a context and triggers a sequence of prioritized steps. to park calls to this parking lot.

    Note

    Generated parking extensions cannot overlap. The only exception is if neither overlapping parkext is exclusive.

  • parkext_exclusive - If yes, the extension registered as parkext will park exclusively to this parking lot.

  • parkpos - Numerical range of parking spaces which can be used to retrieve parked calls.
  • parkinghints - If yes, this parking lot will add hints automatically for parking spaces.
  • parkingtime - Amount of time a call will remain parked before giving up (in seconds).
  • parkedmusicclass - Which music class to use for parked calls. They will use the default if unspecified.
  • comebacktoorigin - Determines what should be done with the parked channelA single call leg passing through Asterisk. Channels represent connections to endpoints and are what dialplan applications act on. if no one picks it up before it times out.

    Note

    Flattened Peer Names - Extensions can not include slash characters since those are used for pattern matching. When a peer name is flattened, slashes become underscores. For example if the parker of a call is called SIP/0004F2040001 then flattened peer name and therefor the extensions created and used on timeouts will be SIP_0004F204001.

    Note

    When parking times out and the channel returns to the dial plan, the following variables are set:

  • comebackdialtime - Timeout for the Dial extension created to call back the parker when a parked call times out.

  • comebackcontext - Context where parked calls will enter the PBXPrivate Branch Exchange, a private telephone switch. Asterisk is a software PBX that routes calls between internal extensions and the outside world. on timeout when comebacktoorigin=no
  • courtesytone - If the name of a sound file is provided, use this as the courtesy tone
  • parkedplay - Who we should play the courtesytone to on the pickup of a parked call from this lot

    Note

    If courtesy tone is not specified then this option will be ignored.

  • parkedcalltransfers - Who to apply the DTMFDual-Tone Multi-Frequency, the touch-tone signals phones send for digit input during a call, used by IVRs and feature codes. transfer features to when parked calls are picked up or timeout.

  • parkedcallreparking - Who to apply the DTMF parking feature to when parked calls are picked up or timeout.
  • parkedcallhangup - Who to apply the DTMF hangup feature to when parked calls are picked up or timeout.
  • parkedcallrecording - Who to apply the DTMF MixMonitor recording feature to when parked calls are picked up or timeout.
  • findslot - Rule to use when trying to figure out which parking space a call should be parked with.
User Notes

Know a tip or gotcha for this topic? Share it below and help others.

Contribute a note

Share a tip, gotcha, or practical example. Keep it under 2000 characters. No questions (use the Asterisk community forums for support). Wrap code in backticks.

Moderated before publishing. Email never shown.