Connecting a Kaleyra WhatsApp Channel

Kaleyra, part of Tata Communications and a Meta Premier Partner, offers WhatsApp alongside SMS, voice and other channels from one platform. Contacts can message your number and send photos, videos, voice notes and documents.

Before you start

You'll need a Kaleyra.io account with your WhatsApp number on it. Kaleyra's guides explain how to create an account and add a WhatsApp number.

You'll also need your account's SID and an API key. Kaleyra explains how to create an API key and find it along with your SID, both under Developers in Kaleyra.io.

Adding the channel

Go to Settings > Channels and click New Channel. Kaleyra WhatsApp is under Social & Chat, or you can type its name in the search box.

Then fill in the form:

Field What to enter
Number Your WhatsApp number, including its country code
Country The country your number is in
SID Your Kaleyra.io account's SID
API Key Your API key

Click Add Channel.

Finishing setup

Once the channel is added, its configuration page shows a receive URL to add in Kaleyra.io, so that messages and delivery updates reach your workspace:

  • Whitelist the receive URL's domain. Click your profile name, then Settings, and on the Settings tab enter the domain and click Save. Kaleyra won't send any callbacks to a domain that isn't whitelisted, so without this you won't get contacts' messages or know whether yours were delivered.
  • Set the receive URL as the callback URL on your WhatsApp number's details page, which is where Kaleyra sends incoming messages.

Kaleyra's guide to WhatsApp callback URLs explains both.

You can come back to the receive URL at any time from the channel's page.

Considerations

Contacts can be sent messages within 24 hours of their last message to you. This channel can't send WhatsApp templates, so it can't message contacts outside that window.

To learn more about WhatsApp channels in general, see Using WhatsApp.

Last updated 12 November 2026