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

# Kaleyra WhatsApp

> Guide on how to add Kaleyra WhatsApp Integration

### Step 1. Account Setup

If you do not have an account with Kaleyra yet, create an account
[here](https://developers.kaleyra.io/docs/create-an-account-in-kcloud). Follow
their WhatsApp onboarding doc
[here](https://developers.kaleyra.io/docs/getting-started-with-whatsapp-messaging)
to get the setup done. Their onboarding setup will help you create a Facebook
Business Manager account and enable WhatsApp on Kaleyra.

### Step 2. Kaleyra Integration in Raven

| Keys                              | Details                                                                                                                |
| --------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
| `From` (WhatsApp Business Number) | Phone number with country code or name. The Sender should be approved from WhatsApp.                                   |
| `API Key`                         | API key for your account. Follow the steps [here](https://developers.kaleyra.io/docs/create-api-key) to create one.    |
| `SID`                             | Account SID (Security Identifier). Generated along with the API key. To check go to Developers > Select API Key > Edit |
| `Namespace`                       | The namespace within which the Message Template is defined (WhatsApp portal)                                           |

***

### Step 3. Delivery Reports

Follow the steps to setup delivery reports:

1. On the Raven dashboard, once you successfully add the Gupshup Integration,
   you will see it in the "Live" tab. Go to the Live tab, and click on Kaleyra
   WhatsApp. You will see a URL as **Status Webhook**, present in the
   integration. Copy this URL.
2. Log in to Kaleyra console. Go to Settings > Enable WhatsApp Callback URLs to
   whitelist this callback url. Paste the Status Webhook URL copied in Step 1.
   [here](https://support.gupshup.io/hc/en-us/articles/360011977800-Will-I-receive-message-status-notification-like-message-read-sent-delivered-etc)
   for more details.

<Info>
  Raven supports sending both Session messaging (User initiated) and Template
  messaging (Business initiated). Support for handling incoming messages for
  session messaging is coming soon.
</Info>

### Step 4. Opt-ins

You can control access by specifying Raven's IP address, or make sure Raven's IP
addresses are whitelisted and not blocked. Please check point 4 in the guide
[here](https://developers.kaleyra.io/docs/generating-an-api-key).

### Advanced

**IP Whitelisting**

You can control access by specifying Raven's IP address, or make sure Raven's IP
addresses are whitelisted and not blocked.

IPs: 65.2.109.100, 65.2.58.233

### Links

* [Kaleyra Website​](https://www.kaleyra.com/whatsapp/)
* [Kaleyra WhatsApp Documentation​](https://developers.kaleyra.io/docs/getting-started-with-whatsapp-messaging)
* [Kaleyra Console](https://kaleyra.io/login?next=L2Rhc2hib2FyZA==)

<Info>
  If you are facing issues with this integration or find something missing, please
  write to us at [support@ravenapp.dev](mailto:support@ravenapp.dev).
</Info>