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

# Notification

The Notification automation type allows you to automatically send notifications through various communication channels when an automation event is triggered. This is useful for keeping users, customers, or teams informed about important events in real-time.

<div align="center">
  <img src="https://mintcdn.com/mile-app/WLXNrGtWP2NU1tMt/images/notification-automation-type.png?fit=max&auto=format&n=WLXNrGtWP2NU1tMt&q=85&s=9291bb64caf49f87b4121e3fc50addf0" alt="Notification automation configuration" width="600" data-path="images/notification-automation-type.png" />

  <p><i>Notification automation type configuration with WhatsApp (Fonnte) channel settings</i></p>
</div>

## Configuration Fields

When you select Notification as the automation type, you need to configure the following settings:

### 1. Channel \*

Select the communication channel through which notifications will be sent. Currently, the platform supports:

* **WhatsApp (Fonnte)** - Send notifications via WhatsApp using Fonnte integration
* **Email** - Send notifications via email with To/Cc/Bcc recipients, a rich text body, and inline images. See [Email Channel](/pages/automation/automation-type/notification-email) for full configuration details.
* **SMS** - Send a plain text SMS to a phone number captured on the task, with `{{ }}` placeholders and a character guideline. Currently visible to internal accounts only during rollout. See [SMS Channel](/pages/automation/automation-type/notification-sms) for full configuration details.

Selecting a channel changes the fields shown below it. WhatsApp shows the Fonnte-specific fields (Receiver Phone Number, API Key, Message) described in this page. Email shows a separate Gmail-style compose card, covered in its own [Email Channel](/pages/automation/automation-type/notification-email) guide. SMS shows a Receiver Phone Number field and a message box with a character counter, covered in the [SMS Channel](/pages/automation/automation-type/notification-sms) guide.

### 2. Receiver Phone Number \*

Select the phone number field from your Flow that contains the recipient's phone number. This field will be used to determine who receives the notification.

The dropdown will show available phone number fields from the Flow you selected in the Event configuration.

### 3. API Key \*

Enter your Fonnte API Key to authenticate and enable WhatsApp message sending.

**How to get Fonnte API Key:**

* Fonnte is a third-party service that enables WhatsApp messaging integration
* You need to integrate your WhatsApp account with Fonnte first
* Once integrated, you'll receive an API Key from Fonnte
* [Learn how to get Fonnte API Key](https://youtu.be/pivL1U-7OLw?list=PL7yPMr9J3bAnZlhcOUx-NvI5UnDZO9rKA)

### 4. Message \*

Customize the notification message that will be sent to recipients. You can use placeholders that will be automatically replaced with actual data:

**Available Placeholders:**

* `{​{ organization name }​}` - Your organization's name
* `{​{ tracking link }​}` - Link to track the task

**Default Message Template:**

```
Greeting, we are from {​{ organization name }​} and will be delivering to your location. Track your delivery here {​{ tracking link }​}. Thank you
```

You can modify the message text while keeping the placeholders intact. The placeholders will be automatically replaced with actual values when the notification is sent.

## Use Cases

### Customer Delivery Notifications

Send automatic WhatsApp messages to customers when:

* A task is created for their delivery
* A driver is assigned to their delivery
* A delivery is completed

### Team Alerts

Notify team members via WhatsApp when:

* High-priority tasks are created
* Tasks are assigned to them
* Important events occur in the system

### Status Updates

Send automated status updates to customers or stakeholders about:

* Order processing stages
* Delivery progress
* Task completion confirmations

## Best Practices

1. **Test Messages:** Send test notifications to verify the message format and placeholder replacement before activating
2. **Clear Communication:** Write clear, concise messages that provide essential information
3. **Placeholder Usage:** Always keep the placeholders in your message template for dynamic data
4. **API Key Security:** Keep your Fonnte API Key secure and don't share it publicly
5. **Phone Number Format:** Ensure phone numbers in your Flow are in the correct format for WhatsApp delivery

## Frequently Asked Questions

**Q: What happens if the phone number field is empty or invalid?**

A: If the phone number field is empty or in an invalid format, the notification will not be sent. Ensure your Flow has proper validation for phone number fields.

**Q: Can I send notifications to multiple recipients?**

A: For WhatsApp, each notification automation sends to one recipient based on the selected phone number field. To notify multiple people, you need to create separate automation rules or ensure multiple phone numbers are captured in your Flow. The Email channel is different, it supports up to 50 recipients across To, Cc, and Bcc in a single send. See [Email Channel](/pages/automation/automation-type/notification-email) for details.

**Q: Do I need a paid Fonnte account?**

A: Only for the WhatsApp channel. Fonnte is a paid third-party service, so you need an active Fonnte subscription and API Key to send WhatsApp notifications through the platform. The Email channel doesn't require any third-party account.

**Q: Can I use other channels besides WhatsApp?**

A: Yes. The platform also supports an **Email** channel, see [Email Channel](/pages/automation/automation-type/notification-email), and an **SMS** channel, see [SMS Channel](/pages/automation/automation-type/notification-sms). SMS is currently visible to internal accounts only while it is being rolled out. Other channels may be added in future updates.

**Q: Can I customize the message for different events?**

A: Yes, you can create separate automation rules for different events, each with its own customized message template.

**Q: Are there character limits for the notification message?**

A: WhatsApp messages through Fonnte may have character limits. It's recommended to keep messages concise and test them before full deployment.
