Introduction

Introduction

Morph.ai provides simple and easy to use REST-like APIs to send message. These APIs will let you easily integrate Morph.ai with your own app.

General Information

  1. Base Url: All the endpoints referenced in the documentation have the following base url: 
    https://open-api.morph.ai/v1/
  2. Request/Response Format: The API accepts JSON in request bodies and requires that the content-type: application/json header to be specified for all such requests. The API will always respond with a JSON object.
  3. CORS: The API also facilitates cross-origin resource sharing so that it can be called from a web application.
  4. Ping: The API also supports a special ping endpoint to check whether the API is up & running or not.

Status Codes

Code
Description
200
For all the successful requests
401
When the Authorization header is missing or the provided token is wrong
400
Something malformed in your header or request body
404
The requested path is not found
500
In case of any unexpected error. Contact support with the RefId provided in the error response.

Authentication

Each API request requires authentication to identify the client that is responsible for making the request. Authentication is provided through an access token.

Getting Access Token 

Contact support to get access token using your email address. Our team will contact you as soon as possible.

Using Access Tokens

For each API request, include this HTTP header: Authorization with the value {access_token}. For example:

Authorization: YOUR-ACCESS-TOKEN



    • Related Articles

    • Morph.ai - Introduction

      Morph.ai is a chat based intelligent marketing automation tool that helps businesses leverage chat as a marketing channel. It is an integrated set of modules and analytics that help you manage the entire customer journey. Creating a bot on the Morph ...

    • 2.01 How to create a chatbot - Introduction

      The first and the foremost step in bot design is to create the conversational modules that are interconnected to each other. One can jump from one conversation to another, hence creating an automated flow. Conversation modules can be created in Chat ...

    • 4.01 How to test your bot and Go live - Introduction

      Once all the conversation flows have been created and workflows have been defined, you are ready to deploy your bot and test out the flows just to be sure that all the conversations are working fine and the user details collected have been saved ...

    • 5.01 How to monitor your bot regularly - Introduction

      This chapter will give you a brief of the ways by which you can monitor the activities on the bot. Now that your bot is live and running, you can keep a check on the conversations happening on the bot.  Audience Tab Acts as a mini CRM which lists all ...

    • 3.01 How to Follow up, Reengage and Nurture your audience - Introduction

      One of the most powerful aspects of the Morph platform is nurturing/follow ups. Follow ups help us to reinitiate chat with the users and keep them engaged on the bot. How to create a segment?Before creating the follow ups you need to define the ...