User-Friendly Chatbot Development

API & Developers

Bill Matrix chatbot offers a natural language understanding framework that enables you to create intelligent chatbots for various services. You can easily integrate and deploy these bots across your favorite messaging apps, allowing them to serve your customers continuously and efficiently.

Verification of Identity

To make any API request, you need to confirm which license is making the request. This confirmation is done using access tokens.

Where can I locate my access tokens?
1

Developer Access Token

This token provides comprehensive access to manage your stories, interactions, entities, webhooks and other features. It is a private token intended solely for your use and should not be shared, as it grants full access to your account.

2

Client Access Token

This token is exclusively for making requests to the query endpoint. It can be incorporated into applications where the code may be viewed by third parties. If needed, you can regenerate it at any time within the Bill Matrix’s chatbot settings.

Managing Errors

The system communicates mistakes using standard HTTP error code language. Usually numbers between 200 and 299 signify a successful operation, 400 and 499 point to an issue such as incorrect or absent data or insufficient authentication and numbers between 500 and 599 indicate a problem on the Bill matrix bot servers end. You will find any additional information in JSON  format within the response status.

Summary of HTTP Status Codes

400

Bad Request

The request should be correct. Please ensure provided arguments match the format specified in the method documentation.

401

Unauthorized

Authorization failed. Please verify using the correct authorization type (bearer token) and a valid developer access token.

404

Not Found

The resource you are attempting to access does not exist or is unavailable. Please check the URL or try again later.

500

Server Error

An unexpected issue occurred on our server. Please attempt your request or contact our support team for assistance.

Problem-Solving

Various factors could lead to issues with your webhooks functionality. Here, you will discover the most common causes of these problems:

1

Response Status

Ensure the response status is 200 or falls in the 300s for redirects.

2

Redirect Loops

Be cautious of scenarios where there are multiple redirects leading to a loop.

3

Incorrect Request URL

Double-check that the request URL is accurate and leads to an existing location.

4

Request Body Problems

Verify that the request body is JSON format and follows the correct structure.

Timeout

If a request takes more than 10 seconds to process, it will automatically decline. This also applies if your server is behind a proxy or load balancer, causing delays exceeding 10 seconds.