> For the complete documentation index, see [llms.txt](https://docs.lightpost.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.lightpost.app/core-concepts/groups/voice-calls.md).

# Voice Calls

Lightpost allows your congregation to make classic voice calls. The voice call tool, utilizing a dedicated number, is meant for one-way communication to phone numbers stored in a users' profiles.

### What is a voice call?

* A voice call is an actual phone call made to a user in a group to communicate a message to.
* Voice calls are sent by one of two options:
  * **Text-to-Speech**
    * You type out a message (see the "how to" section) to send to a group.
    * Lightpost then uses a text-to-speech mechanism to make the phone calls and read the message to the user.
  * **Voice Recording**
    * Lightpost will call you to record a message to be sent to the group.
    * After recording, you listen back and confirm the message. The calls are then made to the group and the recording is played.
* Voice calls do have an extra cost associated with them due to the requirement of using a third party service to make the phone calls.

### How are voice calls counted?

* Lightpost counts voice calls per minute spent calling and reading a message to a users' unique phone number.
* Lightpost automatically filters out duplicate numbers and duplicate recipients.
  * If multiple people have the same phone number, only one call will be made.
  * If a user has multiple phone numbers, a call will only be sent to their primary number.

### How to send a voice call

1. In the Admin, find the group you wish to message, and click on the group.
2. Ensure that the "**Enable messaging by Voice**" option is selected in the "**Messaging**" tab and save changes.
   1. Optionally choose the **Voice type** (Female or Male) used for typed messages.
   2. Optionally enable the "Advanced Answering Machine Detection"
3. Open **Group Roles** and enable **Authorized Sender** for each person who may send a voice message. Account Admins must also be explicitly authorized for the group.
   1. Only people in the group are listed. Add the person on the group's **Members** page first if needed.
4. Go to the "**Send Voice**" section available for the group.
5. Choose how to create the message:
   1. **Record Your Voice** — choose the phone number to be called at under "**Call me at**" and click "**Record Voice Message**". See [Recording a message](#recording-a-message) below.
   2. **Type a Message** — type the message you wish to be read and click "**Send Voice Calls**".
6. To send it later, select "**Schedule for later**" and choose a date and time before sending.

Sending from the Admin requires the **Manage Groups** admin permission in addition to being an Authorized Sender. See [Group Roles and Event Permissions](https://docs.lightpost.app/core-concepts/groups/group-roles.md) for more about Authorized Senders.

#### From the member web app or mobile app

Authorized Senders can also send voice calls without using the Admin:

* **Member web app** — go to **Groups**, open the group, select **Messaging**, and use the **Voice** tab. It has the same **Record Your Voice** and **Type a Message** options.
* **Mobile app** — Authorized Senders can send and schedule voice calls from the Lightpost mobile app, including for groups they are not a member of.

In the member web app, **Messaging** only appears for Authorized Senders who are members of the group, and the group must appear in their **Groups** list. A group is listed there when it has Group Posts or a Group Forum, a group calendar, or video calls turned on.

### Recording a message

1. Lightpost calls the phone number you chose. The number must be one of the phone numbers on your profile.
2. Record your message after the beep and press **#** when finished. A recording can be up to 5 minutes long.
3. Lightpost plays the recording back to you. Press **1** to send it to the group, **2** to record a new message, or **3** to cancel.

If you hang up without choosing, the recording is not sent. It waits on the group's **Messaging** page in the member web app, where you can listen to it and choose **Send**, **Re-record**, or **Cancel**. You can also simply start a new recording.

### How to schedule a voice call

Select "**Schedule for later**" before sending, then choose the date and time. Times use your account's time zone, and the time can be set between 6:00 AM and 10:00 PM. A recorded message is still recorded and confirmed right away; only the calls to the group wait for the scheduled time.

Scheduled messages can be cancelled any time before they are sent:

* **In the Admin** — open the group's **Scheduled** section and click **Cancel**. The section appears when the group has a scheduled message.
* **In the member web app** — open the group's **Messaging** page and use the **Scheduled** tab.

### How to view voice call history

1. In the Admin, find the group you wish to message, and click on the group.
2. Go to the **"Message History"** section.
3. Click on any past message to view details about who was called and any errors or failures.

### Advanced Answering Machine Detection

Lightpost also has an option when enabling voice calls to do advanced answering machine detection. This does extra work to detect if the voice call has not been answered, and instead been directed to a person's answering machine.

This can help with voice calls being properly played after the beep of an answering machine, as opposed to not.

With our service provider, this has a purported 94% accuracy rate.

It does introduce an additional 1-2 second pause or delay when a human answers the phone, while the service determines if a person or an answering machine picked up.
