Before integrating Kannel with Novu, you should have Kannel set up and configured as an SMS gateway on your server. Let’s look at how you can do that:

​

Setting up Kannel

1. First, you need to install Kannel on your server. You can download it from the official-website or use a package manager specific to your operating system (e.g., apt- get for Ubuntu, yum for CentOS, etc.).

2. Kannel’s configuration is done through a file called kannel.conf. You need to edit this file to specify your SMS provider settings. Here’s a basic configuration example:

   group = smsc
   smsc = smpp
   smsc-id = YourSMSCID
   host = SMSC_Hostname_or_IP
   port = SMSC_Port
   system-type = SMSC_System_Type
   smsc-username = YourUsername
   smsc-password = YourPassword
   max-pending-submits = 10
   allow-ip = "127.0.0.1"
   

   Replace the placeholders (e.g., YourSMSCID, SMSC_Hostname_or_IP, SMSC_Port, SMSC_System_Type, YourUsername, and YourPassword) with the actual values provided by your SMS provider.

3. You can define services that will handle incoming and outgoing SMS messages. These services specify how Kannel should process SMS requests. Here’s an example of an SMS service configuration:

   group = sendsms-user
   username = YourUsername
   password = YourPassword
   concatenation = true
   max-messages = 3
   

   Adjust the settings to your needs.

4. Start Kannel with the following command:

   bearerbox /path/to/kannel.conf
   

   Make sure to replace /path/to/kannel.conf with the actual path to your Kannel configuration file.

​

Creating a Kannel integration with Novu

After setting up your Kannel, follow these steps to integrate with novu:

• Visit the Integrations Store on Novu.

• Click the “Add a provider” button.

• Select Kannel service.

• Choose your preferred deployment environment: Development or Production. Then Click the Create button.

• Once the integration is active, you’ll need to configure it. This configuration usually involves providing the necessary details for Novu to connect to your Kannel SMS gateway. These details typically include:

  • Kannel Gateway URL or IP Address: If your Kannel SMS gateway is hosted on your server, you should use the server’s IP address or hostname.
  • Port: The port number through which Novu should communicate with Kannel (usually 13013, or a custom port you’ve configured in Kannel).
  • Username and Password: If you’ve set up authentication for your Kannel SMS gateway, provide the username and password required for authentication:

  group = smsc
  smsc = smpp
  smsc-id = YourSMSCID
  host = SMSC_Hostname_or_IP
  port = SMSC_Port
  smsc-username = YourUsername
  smsc-password = YourPassword
  max-pending-submits = 10
  allow-ip = "127.0.0.1"
  

  In this example, YourUsername and YourPassword are the credentials you’d use for authentication.

• Fill in the From field.

• Click on the Update button.

• You should now be able to send notifications using Kannel in Novu.