Create Channel

Effortlessly set up an API channel inbox in Bevatel, allowing you to send and receive messages using Bevatel APIs with simple configuration steps.

How to create an API channel inbox?

Setting up an API channel consists of the following steps.

1. Create API Channel inbox
2. Send messages using Bevatel APIs
3. Receive webhooks on new messages from Bevatel

This document allows you to create and configure an API channel inbox in Bevatel installations.

Step 1: Go to Settings > Channels and click on "Add Channel".

Step 2: Select API from the list of channels.

Step 3: Provide a name for the channel and a callback URL (the events and corresponding payload are defined in 
the subsequent articles)

Step 4: Add agents to the channel

Step 5: Hooray!! The inbox setup is complete.

Now the channel setup is complete, let us try to send a message using Bevatel APIs.

When the user tries to edit the inbox configuration

In the inbox configuration's collaborators section:

• When you add an agent in the Agent field, any user designated as an agent can see and access this inbox from the Conversation module. They can manage conversations in this inbox.
• However, when you add a team in the Team field, users attempting to assign conversations to a specific team from the Conversation module will only see the teams that have been added to the related inbox. This restricts conversation assignment options to the teams associated with the particular inbox, ensuring that conversations are appropriately distributed among the specified teams.
  
  

Send Messages via Bevatel API Channel 

This guide explains how to send messages through the Bevatel API Channel using the latest webhook endpoint. The updated API streamlines the workflow into a single request, eliminating the need for separate contact or conversation creation.

---

Key Concepts

• Inbox: Represents a communication channel such as WhatsApp, Facebook, or API.

• Contact: A real-world user involved in the messaging.

• Conversation: Automatically handled by the system upon sending a message.

• Message: The actual text sent between an agent and a contact.

---

Endpoint

1. POST https://chat.bevatel.com/webhooks/api_channel
   

If everything is successful, you will see the conversation on the dashboard as follows.

{
  "inbox_id": ,
  "contact": {
    "phone_number": ""
    // Optional if the contact already exists:
    // "contact_id": 
  },
  "message": {
    "content": "Hello world, you are my favourite message"
  }
}

You will be notified when a new message is created on the URL specified while creating the API channel.