Website Contacts & Meta Data

Get the essentials first!

To use the S10U APIs, You need to insure that you have following details with you.

A. UUID - You can get the UUID from the local web session storage as show in the image below:

🖼️ Image placeholder: /images/image-44-48879b5d.png How to get the UUDI

B. Bot ID & User ID: One can get the Bot ID and User ID from your Bot Script or Bot page URL. Below is the sample Example.

For Chatbot page URL

// Chatbot Page URL Structure

https://page.s10u.online/BotId/CustomerId

// The first value after .com is the BotId and second value is the CustomerId.

For Chatbot Script

// Chatbot Script Structure

<script id="S10U-messenger-widget" src="https://cdn.s10u.online/S10U.js" defer>BotId,CustomerId</script>

// The first value after defer> is the BotId & second value is the CustomerId.

C. Auth Token: We haven't automated everything yet. Please contact our support team to get the same.

Now you are ready to run the POC

API References

Please use the below APIs in order to play with your leads and chat data.

Create a lead in the S10U

As soon as any user opens up the Bot, It creates one UUId; pass the same along with the other required details to create and update the lead's details.

API to update a chat/lead data

PUT https://api.v7.express-chat.ai/inbox/direct/lead

As soon as any user opens up the Bot, It creates one UUId; pass the same along with the other required details to create and update the lead's details.

Headers

Name	Type	Description
x-bp-token*	String	API Token

Request Body

Name	Type	Description
uuid*	String	Unique ID of a chat user
botId*	String	Unique ID of the bot
customerId*	String	Unique ID of the customer account
agentId	Boolean	Unique ID of the agent assigned
status	String	Valid status for the chat. Available values: 'OPEN', 'INPROGRESS', 'REVIEW', 'ONHOLD', 'DEPENDANCY', 'CLOSED'
picture	String	A valid image HTTP URL
name	String	Name of the lead
email	String	Email of the lead
phone	String	Phone number of the lead
dialCode	String	Dial Code including "+" sign
notes	Array<{title: string, description: string}>	Additional notes for the chat
tags	Array<String>	Additional tags for the chat
attributes	Array<{key: string, value: string}>	Custom attributes for the chat

{
    "success": true,
    "message": "ok",
    "code": 200
}

{
    // Response
}

{
    // Response
}

Name	Type	Description
botId*	String	Unique ID of the bot
customerId*	String	Unique ID of the customer account
page*	String	Page number
type*	String	"lead" to fetch only leads "non-lead" to fetch non lead chats

Headers

Name	Type	Description
x-bot-token*	String	API Token

{
    "success": true,
    "message": "ok",
    "data": [
        {
            "_id": "63d9ffa77a8d152facbe2f2f",
            "uuid": "7e88d192-9b20-4035-9b68-d4ac3d58a34f",
            "createdAt": "2023-02-01T05:59:03.533Z",
            "isOnline": false,
            "lastMessage": {
                "at": "2023-02-01T06:00:20.000Z",
                "by": "bot",
                "text": "Welcome to S10U. I am here to help you."
            },
            "lastSeenAt": "2023-02-01T06:00:21.000Z",
            "profile": {
                "notes": [
                    {
                        "title": "Sample title",
                        "description": "Sample description",
                        "_id": "63db5c4abcbc3be2e95b20ae"
                    }
                ],
                "userDetails": {
                    "name": "Sample name",
                    "picture": "my-picture",
                    "contact": {
                        "email": "Sample email",
                        "phone": {
                            "number": "Sample number",
                            "prefix": "91"
                        }
                    },
                    "city": "Sample city",
                    "country": "Sample country",
                    "gender": "MALE",
                    "tags": [
                        "Sample tag"
                    ],
                    "attributes": [
                        {
                            "key": "ID",
                            "value": "BP001"
                        }
                    ]
                }
            },
            "status": "INPROGRESS",
            "updatedAt": "2023-02-02T06:46:34.119Z",
            "websiteVisits": 1,
            "_agentAssigned": "631aa793bcfa100487d13d0d"
        }
    ],
    "code": 200
}

{
    // Response
}

{
    // Response
}

❓ Got any questions?

If you have any questions, you can look into our repository of FAQs, most likely, you will find your answer here, If not, write us at production@S10U.co.za

Website Contacts & Meta Data

Get the essentials first!

API References

Create a lead in the S10U

API to update a chat/lead data

Headers

Request Body

Get leads listing and Its meta data

API to get listing of chats/leads

Query Parameters

Headers

❓ Got any questions?

On this page