botimize - Analytics built to optimize your bots
-
Create a free account at Botimize to get an API key. Or you can talk to our botimize helper Facebook Messenger Helper or Telegram Helper to create a public project.
-
Install botimize SDK with
pip:pip install botimize
Use Botimize API key to create a new botimize object, and <PLATFORM> should be facebook, telegram, line or generic.
from botimize import Botimizebotimize = botimize.Botimize(<YOUR-API-KEY>, <PLATFORM>)botimize = botimize.Botimize('NS1W0O5YCIDH9HJOGNQQWP5NU7YJ0S0S', 'facebook')To log incoming message is very easy, just put the body received from platform webhook into log_incoming().
botimize.log_incoming(request.body){
"object": "page",
"entry": [
{
"id": "247349599062786",
"time": 1492541234486,
"messaging": [
{
"sender": {
"id": "1846048872078817"
},
"recipient": {
"id": "247349599062786"
},
"timestamp": 1492541234394,
"message": {
"mid": "mid.$cAAC6AFgUYTphs6kk2lbgmPaOon0R",
"seq": 3915,
"text": "hello facebook"
}
}
]
}
]
}{
"update_id":596819141,
"message":{
"message_id":27,
"from":{
"id":161696362,
"first_name":"Kuan-Hung",
"username":"godgunman"
},
"chat":{
"id":161696362,
"first_name":"Kuan-Hung",
"username":"godgunman",
"type":"private"
},
"date":1492511288,
"text":"hello telegram"
}
} {
"events":[
{
"type":"message",
"replyToken":"6a37af4d99a94ce9bbe9184171398b70",
"source":{
"userId":"Uc76d8ae9ccd1ada4f06c4e1515d46466",
"type":"user"
},
"timestamp":1492439626890,
"message":{
"type":"text",
"id":"5952264121603",
"text":"hello"
}
}
]
}incoming_log = {
'timestamp': '<TIME OF MESSAGE(in milliseconds)>',
'recipient': {
'id': '<UUID_OF_RECIPIENT>',
'name': '<NAME_OF_RECIPIENT>'
},
'sender': {
'id': '<UUID_OF_SENDER>',
'name': '<NAME_OF_SENDER>'
},
'message': {
'type': '<MESSAGE_TYPE>', // 'text', 'image', 'audio', 'video', 'file', 'location'
'text': '<MESSAGE_CONTENT>'
}
}
botimize.log_incoming(incoming_log)This is a little different from log_incoming() because outgoing messages have token for sending message to client. "Fortunately", there are three platforms and have three differents ways to authorize by using token. "Unfortunately", one easy way is all Botimize needs.
outgoing_log = {
'recipient': { 'id': '1487766407960998' },
'message': 'hello facebook messenger',
'accessToken': 'EAAXUgsVmiP8BAMcRWxLa1N5RycMzZBfjwiekoqCik6pZASPsnmkJtG29gp5QXdyMaKfFg0iZCIDlqhfhTZCLqRKuM4hUCfdZBcxl8GzKgZA0AwI8syxG49M9OaZCsjyZC8FPg30yIRDFG5hp9jNNtvqtWW0KKzB9a59rTkZBsgz2oe4QZDZD'
}
botimize.log_outgoing(outgoing_log)outgoing_log = {
'chat_id': '161696362',
'text': 'hello telegram',
'token': '308726257:AAHnmJpvkAepqirk82ZOrgtF6Hz2ijbRavA',
}
botimize.log_outgoing(outgoing_log)outgoing_log = {
'replyToken': '9bd439c6961346d7b2ec4184469b9946',
'messages': [{
'type': 'text',
'text': 'hello, this is a message from LINE chatbot',
}],
'channelAccessToken': 'GxvuC0QfatJ0/Bv5d3DoVbUcfVd6MXLj9QY8aFHSqCOdkfjD1I5dtbKZBNMbmLmwKox1Ktd0Kcwfsxm9S5OmIwQoChcV1gPlK/1CI8cUe3eqaG/UrqL65y1Birb6rnssT0Acaz+7Lr7V2WVnwrQdB04t89/1O/w1cDnyilFU=',
}
botimize.log_outgoing(outgoing_log)outgoing_log = {
'timestamp': '<TIME OF MESSAGE(in milliseconds)>',
'recipient': {
'id': '<UUID_OF_RECIPIENT>',
'name': '<NAME_OF_RECIPIENT>'
},
'sender': {
'id': '<UUID_OF_SENDER>',
'name': '<NAME_OF_SENDER>'
},
'message': {
'type': '<MESSAGE_TYPE>', // 'text', 'image', 'audio', 'video', 'file', 'location'
'text': '<MESSAGE_CONTENT>'
}
}
botimize.log_outgoing(outgoing_log)