Contact Us

If you still have questions or prefer to get help directly from an agent, please submit a request.
We’ll get back to you as soon as possible.

Please fill out the contact form below and we will reply as soon as possible.

  • Go to Haptik Website
  • Join the Community
  • Contact Us
  • Home
  • Deployment
  • Bot as an API

How to send message to Haptik using API?

Written by Medha Anand

Updated on August 23rd, 2021

Contact Us

If you still have questions or prefer to get help directly from an agent, please submit a request.
We’ll get back to you as soon as possible.

Please fill out the contact form below and we will reply as soon as possible.

  • Getting Started
    Build Deploy Analyse Manage Account
  • Bot Building
    Essentials Smart Skills Steps User Messages Bot Responses Entities Connections Customisations User feedback collection Testing Whatsapp Bots NLU
  • Conversation Design
    Conversation Design for Whatsapp Bots Design Basics Designing for Platforms
  • Developer Guides
    Code Step Integration Static Step Integration Shopify Integration SETU Integration Exotel Integration CIBIL integration Freshdesk KMS Integration PayU Integration Zendesk Guide Integration Razorpay Integration LeadSquared Integration
  • Deployment
    Web SDK Whatsapp Facebook Instagram Sunshine Conversation LINE Google Business Messages Telegram MS Teams Bot as an API iOS SDK Android SDK
  • Agent Setup
    Haptik's Smart Agent Chat Zendesk Chat Salesforce Service Cloud Freshchat Zoho NICE CXOne
  • Analytics & Reporting
    Intelligent Analytics
  • Troubleshooting Guides
    Error Messages FAQs
  • Release Notes
+ More

Table of Contents

Log Message to Haptik via REST APIURLHeadersPostResponseError ResponseSample CURL command

Log Message to Haptik via REST API

The Log Message API allows you to send messages via a POST request to the Haptik Platform. The URL for message logging is generated on the Haptik Platform Dashboard.

URL

https://<BASE_URL>/v1.0/log_message_from_user/

Headers

Authorization: Bearer <TOKEN>
client-id: <CLIENT_ID>
Content-Type: application/json
  • Authorization - The Authorization header of each HTTP request should be “Bearer” followed by your token which will be provided by Haptik
  • client-id - The client id for your account which will be provided by Haptik
  • Content-Type - application/json

Post

{
 "user": {
 "auth_id": "<AUTH_ID>"
 },
 "message_body": "<MESSAGE_BODY>",
 "message_type": 0,
 "business_id": 343
}
  • auth_id - This is an alphanumeric User identifier from your system
  • business_id - This is a numeric identifier for channel/queue that you wish to register the message on.
  • message_body - The message body containing the message to be sent to the bot or agent.
  • message_type - This defines the processing pipeline for messages, standard messages are of type 0

Response

A successful request to the log message sent API will return a 200 status code with a JSON response object. It will contain a unique message id and other metadata about the message.

{
 "message_id": 1411200492,
 "message_body": "<MESSAGE_BODY>",
 "created_at": "2018-10-04T12:41:27.980Z",
 "message_type": 0
}
  • message_id - message id generated by haptik system
  • message_body - message body that was logged in the haptik system
  • created_at - ISO timestamp denoting when the message was created in the haptik system
  • message_type - This defines the processing pipeline for messages, standard messages are of type 0

Error Response

If the user with auth_id is not registered, then the API will return a 403 status code.

{
 "error_message": "user is not registered"
}

If the Authorization header is missing or invalid, then the API will return a 401 status code.

{
 "error_message": "invalid authorization details"
}

Sample CURL command

curl -X POST \
 https://<BASE_URL>/v1.0/log_message_from_user/ \
 -H 'Authorization: Bearer <TOKEN>' \
 -H 'client-id: <CLIENT_ID>' \
 -H 'Content-Type: application/json' \
 -d '{
 "message_body": "<MESSAGE_BODY>",
 "business_id": 343,
 "message_type": 0,
 "user": {"auth_id": "<AUTH_ID>"}
}'

Was this article helpful?

Yes
No
Give feedback about this article

Related Articles

  • How to create/update a Haptik User using API?
  • How to ensure API security?
  • What is Bot as an API?
  • Which information is sent as Webhook Payload?

Platform

  • Conversation Studio
  • Smart Skills
  • Advanced NLU
  • Intelligent Analytics
  • Omnichannel
  • Smart Agent Chat
  • Enterprise Security
  • Integrations

Solutions

  • Conversational Commerce
  • Lead Generation
  • Customer Care
  • WhatsApp
  • Conversational IVR
  • Google Business Messages

Industries

  • Retail/ E-Commerce
  • Financial Services
  • Travel & Hospitality
  • Telecom

Knowledge

  • ROI Calculator
  • Reports & Research
  • Case Studies
  • Webinars
  • ISAT
  • Tech Blog
  • Business Blog
  • Resources
  • Haptik v/s Yellow
  • Haptik v/s Liveperson
  • Haptik v/s IBM Watson
  • Haptik v/s Verloop
  • Conversations on AI

Company

  • Why Haptik
  • About Us
  • Careers
  • News & Media
  • Awards & Recognition
  • Contact Us
  • Partnerships
  • Investor Relations

Subscribe

Sign up to recieve the latest updates

Find us on

  • Twitter-footer
  • Linkedin-footer
  • YT-footer
  • Insta-footer
  • G2-footer
  • Facebook-footer

Copyright © jio Haptik Technology Limited 2021 | Data Security & Privacy Policy | GDPR

North America | Asia Pacific | Africa | enterprise@haptik.ai

Definition by Author

0
0