Create Email Callback Profiles with Dynamic Variables

You can create an Email callback profile within the Kaleyra.io user interface to get information about the Email delivery status. The wizard to set up the callback profile for the Email channel provides a list of dynamic variables specific to the Email channel that you can individually select to get the latest information about your email message that you are interested in.
After successfully creating an Email callback profile, you must use the ‘callback profile ID’ parameter in an Email API request (POST) to fetch all the Email delivery information in an endpoint that you specify.

📘

Note:

• If you have more than one Callback Profile created for different channels, make sure you add the correct callback profile Id in the Email API requests.
• A callback profile created for the Email channel cannot be used for other channel API requests.
• Once a callback profile is created for the Email channel, you can only edit the list of dynamic variables you want to receive in the callback from Kaleyra or delete the profile.

To create an Email callback profile:

1. On the profile settings drop-down list, select the Callback Profiles option.

The Callback Profiles page appears.

2. On the Callback Profiles page, click Add New.
   The Add Callback Profile window appears.

Perform the following steps to add all the relevant information in the ‘Add callback profile’ page.

1. In the Title field, enter a title for the callback profile. This is a mandatory field.

2. From the Select Channel API list, select the option ‘email - Email Gateway APIs' to create a callback profile that you can use to receive the updated information about the Email delivery status.
   Once you select the option ‘email - Email Gateway APIs’, the Events for the selected channel field is automatically set to the ‘Email Send’ option.

3. In the HTTP Method field, select a method you want Kaleyra to use when calling your system to send you back the information about email messages.

   📘 Note: Only the POST method supports the use of dynamic variables for the Email channel.

4. In the Enter Endpoint field, enter the URL at which the callback information should be received.

5. In the Dynamic Variables field, click View to view and select the dynamic variables for the Email channel. The dynamic variables represent all the possible information that you can retrieve about the Email as part of the callback that kaleyra.io will send to your system. You may select all of them, or only the fields you are interested in.
   The List Dynamic Variables for the Email channel appears.

6. In the List Dynamic Variables window, to select all the dynamic variables,

• Click Select All or manually select the dynamic variables check-boxes that you want to receive in the callback sent from Kaleyra to your system.
• After selecting the variables, click Copy to Clipboard.
• Click ‘X’ (CLOSE) on the window to close the window.

7. Using the mouse, right click and paste the selected dynamic variables either in the Request Body field (POST method).
8. In the Enable form data or urlencoded headers field, select the 'form data' or the 'urlencoded header'.

• Form data headers are used for complex data while submitting forms with file uploads.
• URL Encoded headers are used for simpler text in HTTP requests with the data encoded in key-value pairs.

9. In the Header fields, enter the key-value pair values to add additional information to be added to the HTTPS request generated from Kaleyra to your system, for example, authentication details.

10. Use the +Add more button to add multiple Header fields.
11. Use the Enable Encryption toggle button to enable encryption of the callback information.
    When you enable this toggle button, the Algorithm, Key, and the Initialization Vector, and Parameters fields appear.
    Enter values in these fields. To know more about these fields, see: https://developers.kaleyra.io/docs/callback-profiles-in-accountssettings
    The Enable Callback Required Options toggle button is NOT applicable for the Email channel.
12. To check if the callback profile that you have created is ok, click Test.
    A dummy version of a callback will be triggered from Kaleyra to your system applying the configuration done so far.
13. After filling in all the details, click Save to save the callback profile for the Email channel with the specified dynamic variables and configuration.
    Once you save the callback profile on the UI, you can see the callback profile ID as shown on the Callback Profiles list.

10. Copy the callback profile ID from the list and add it to the ‘callback_profile_id’ parameter in the ‘send Email API request’ as shown in the following example, along with the other necessary Email API parameters.
    "callback_profile_id": "IN_453d2677-2c91-4610-9c01-eefbeec5f697".
    See Single Email page: Send Single Email for more details on using the callback_profile_id parameter in an API request.

The following table shows the field descriptions on the Add Callback profile window.

The following table shows the dynamic variables for Email channel and their descriptions with examples.

Email delivery statuses

The following table shows the Email delivery statuses and their descriptions.