# Dial-In

{% hint style="info" %}
Dial-in is currently in closed Beta and available to selected customers only.\
Email us at <embedded@whereby.com> to join our pilot program (terms and conditions apply).
{% endhint %}

## Setup&#x20;

### Per room configuration

You can configure the Dial-in feature for individual rooms. Use the [POST /meetings](https://docs.whereby.com/reference/whereby-rest-api-reference/meetings#post-meetings) request to create the new room. During the creation request, add the following fields to the request’s body:

```json
{    
    "endDate": "2099-03-25T13:30:00.000Z",
    “isDialInEnabled”: true,
    "fields": ["dialIn"]
}
```

{% hint style="success" %}
Multiple fields can be specified in the same request, including things like [hostRoomUrl](https://docs.whereby.com/reference/whereby-rest-api-reference/meetings)
{% endhint %}

**Example response:**

```json
{
	"startDate": "<now>",
	"endDate": "2099-03-25T13:30:00.000Z",
	"roomName": "/example-room”,
	"roomUrl": "https://example.whereby.com/example-room",
	"meetingId": "1234",
	"dialIn": {
		"code": "1234567890",
		"phoneNumbers": [
			{
				"countryCode": "US",
				"phoneNumber": "111-867-5309"
			}
		]
	},
	"roomPreferences": {
		"dialIn": true
	}
}

```

### Getting details of the dial-in access codes

To obtain the Dial-in details and access codes for a specific meeting, use the `meetingId` and send a [GET request](https://docs.whereby.com/reference/whereby-rest-api-reference/meetings#get-meetings) with `?fields=dialIn` as a query param. The details are provided in a text response in JSON format, and include:

* List of Dial-in phone numbers from different countries that participants can call to join the meeting
* Dial-in access code

The above request will work for both a specific `meetingId`, or all active meetings. The response will be an array of meetings, and the meetings will have the Dial-in details but only if they were created with Dial-in enabled.

### Creating callable links

The phone number and room code can be combined and presented as a link on your website or HTML email, allowing users to 'click' the link and dial into the room without having to manually enter the code.

To do so, create an [anchor](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/a) element with the `href` set to `"tel:<phone number>,<room code>"` like so:

`<a href="tel:111-867-5309,1234567890">Click here</a>`

{% hint style="info" %}
The comma separating the phone number from the room code above causes the phone to wait for an answer before entering the code.
{% endhint %}

Here's how that renders on this website: [Click here](tel:111-867-5309,1234567890)

## Additional information

### Using webhooks

Webhook events can be used to track Dial-in participants. When a dialed-in participant joins or leaves the meeting, Whereby sends a [webhook](https://docs.whereby.com/meeting-content-and-quality/insights-suite-and-api/webhooks#transcription-data-properties) event with details:

* Participant’s phone number
* Participant’s date and time of joining
* Participant’s date and time of leaving the room

## Known limitations

1. The Dial-in feature currently provides voice messages to participants in **English only**.
2. The Dial-in feature is **not compatible** with our [Breakout Groups](https://docs.whereby.com/whereby-101/customizing-rooms/breakout-groups-with-embedded) feature.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.whereby.com/whereby-product-features/dial-in.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.