BotV1 API

Message

Send Message

POST https://eko-h1.dev.ekoapp.com/bot/v1/direct/message

send message from bot to user's direct chat

Headers

Name	Type	Description
Authentication	string	token from OAuth2

Request Body

Name	Type	Description
uid	string	targeted userId
message	object	message's object
message.type	string	text
message.data	string	message that you want to send

201

{
  "status": "success",
  "message": {
        "id": "5de48f26707e9f529a9c03ff",
        "type": "text",
        "groupId": "5de48f02707e9f529a9c03f8",
        "threadId": "5de48f02707e9f529a9c03f9"
  }
}

// example
{
    uid: <userID>
    message: {
        type: "text",
        data: <any text>
    }
}

POST https://eko-h1.dev.ekoapp.com/bot/v1/direct/picture

send picture from bot to user's direct chat

Headers

Name	Type	Description
Authentication	string	token from OAuth2

Request Body

Name	Type	Description
uid	string	targeted userId
file	string	picture
caption	string	picture's caption

201

{
  "status": "success",
  "message": {
        "id": "5de48ecd707e9f529a9c03f4",
        "type": "picture",
        "groupId": "5dd37cc68c69855b878f2f7c",
        "threadId": "5dd37cc68c69855b878f2f7d"
    }
}

Send File

POST https://eko-h1.dev.ekoapp.com/bot/v1/direct/file

send picture from bot to user's direct chat

Headers

Name	Type	Description
Authentication	string	token from OAuth2

Request Body

Name	Type	Description
uid	string	targeted userId
file	string	file

201

{
  "status": "success",
  "message": {
        "id": "5de48ef0707e9f529a9c03f7",
        "type": "file",
        "groupId": "5dd37cc68c69855b878f2f7c",
        "threadId": "5dd37cc68c69855b878f2f7d"
    }
}

Send Message To Group

POST https://eko-h1.dev.ekoapp.com/bot/v1/group/message

send message from bot to user's direct chat

Headers

Name	Type	Description
Authentication	string	token from OAuth2

Request Body

Name	Type	Description
gid	string	targeted group
tid	string	If you leave it empty, the message will send to main chat
message	object	message's object
message.type	string	text
message.data	string	message that you want to send

201

{
  "status": "success",
  "message": {
        "id": "5de48f26707e9f529a9c03ff",
        "type": "text",
        "groupId": "5de48f02707e9f529a9c03f8",
        "threadId": "5de48f02707e9f529a9c03f9"
    }
}

Send Picture To Group

POST https://eko-h1.dev.ekoapp.com/bot/v1/group/picture

send picture from bot to user's direct chat

Headers

Name	Type	Description
Authentication	string	token from OAuth2

Request Body

Name	Type	Description
gid	string	targeted group
tid	string	If you leave this one empty, bot will send the picture into the main chat instead.
file	string	picture
caption	string	picture's caption

201

{
  "status": "success",
  "message": {
        "id": "5de48f26707e9f529a9c03ff",
        "type": "picture",
        "groupId": "5de48f02707e9f529a9c03f8",
        "threadId": "5de48f02707e9f529a9c03f9"
    }
}

Send File To group

POST https://eko-h1.dev.ekoapp.com/bot/v1/group/file

send picture from bot to user's direct chat

Headers

Name	Type	Description
Authentication	string	token from OAuth2

Request Body

Name	Type	Description
gid	string	targeted groupId
file	string	file

201

{
  "status": "success",
  "message": {
        "id": "5de48f26707e9f529a9c03ff",
        "type": "file",
        "groupId": "5de48f02707e9f529a9c03f8",
        "threadId": "5de48f02707e9f529a9c03f9"
    }
}