Every communication between sub_dealer‘s personnel and customer can be tracked and acted upon
braango will post every responses, either from personnel or from customer to partner’s server
partner needs to register web_hook URL with every personnel it wants tracked or it can set global web_hook for partner_dealer account. Having individual web_hook per personnel is recommended as it allows to tie communication per personnel
Message format
When a message is received by a braango system it is forwarded to partner server via registered web_hook . braango system makes a POST call to the registered URL with registered api_key
The format of the response is as described below
{
"body" : {
"numbers" : [
{
"phone_number" : "xxxxxxxxx",
"date_consumer_responded" : "11/30/2017:07:41:PM",
"bridge_message" : false,
"stop_requested" : false,
"bridge_number_used" : "(617) 941-3276",
"bridge_dealer" : true,
"message" : "Text"
}
]
},
"header" : {
"isn-api-key" : "ISNWF0P30WM0CMK",
"account-type" : "partner",
"operation" : "DEALER_MSG",
"id" : "390e68b6-98e6-466d-b729-92a1f2146613"
}
}
The following is response when consumer is messaging the dealer
{
"_id" : ObjectId("5a20d4456056b40fc5a2e860"),
"body" : {
"numbers" : [
{
"phone_number" : "+15103662533",
"media_urls" : [],
"date_consumer_responded" : "11/30/2017:08:01:PM",
"bridge_message" : false,
"stop_requested" : false,
"bridge_number_used" : "(617) 941-3276",
"bridge_dealer" : true,
"message" : "Hello World"
}
]
},
"header" : {
"isn-api-key" : "ISNWF0P30WM0CMK",
"account-type" : "partner",
"operation" : "CONSUMER_MSG",
"id" : "a0a4f4ac-24ee-4e0b-b667-23147f3770b4"
}
}
Explanation of the fields is below :
"header" : {
"isn-api-key" : "<Value set during create web hook call>"
"account-type" : "<partner|dealer>",
"operation" : "<CONSUMER_MSG|DEALER_MSG>",
"id" : "a0a4f4ac-24ee-4e0b-b667-23147f3770b4"
}
"body" : {
"numbers" : [
{
"phone_number" : "<originating number, not a mask number>",
"media_urls" : [],
"date_consumer_responded" : "11/30/2017:08:01:PM",
"bridge_message" : <always false, future upgrade>,
"stop_requested" : <true|false>,
"bridge_number_used" : "(617) 941-3276 <braango number>",
"bridge_dealer" : true|false <whether braango number or blast number>,
"message" : "Hello World <actual message"
}
]
},
```