Pro testování webhooků doporučujeme využít službu https://requestbin.com/.
Webhooky jsou doručeny na zadanou URL adresu metodou POST ve formátu JSON a to s tímto obsahem:
{
"account":"filounek",
"pipeline":13179,
"action":"79303",
"email":"filounek@ecomail.cz",
"subscriber":{
"id":6,
"name":null,
"surname":"",
"email":"filounek@ecomail.cz",
"gender":null,
"vokativ":null,
"bounce_soft":0,
"bounce_soft_count":0,
"bounced_hard":0,
"bounce_message":null,
"inserted_at":"2017-11-10 10:34:31",
"last_position":"CZ,Hlavni mesto Praha",
"rating":5,
"pipl":null,
"nameday":null,
"source":"app_form",
"company":null,
"street":null,
"city":null,
"country":"CZ",
"zip":null,
"phone":"+420123456789",
"pretitle":null,
"surtitle":null,
"birthday":null,
"notes":null,
"vokativ_s":null,
"optimized_delivery":null,
"tags":[
"tag1"
],
"webevents":"[{\"label\": \"123456\", \"action\": \"someaction\", \"category\": \"shop\", \"property\": null, \"timestamp\": \"2023-03-15 10:06:31\"}}]",
"last_open":"2024-09-02 14:15:46",
"last_click":"2024-08-05 12:13:28",
"last_pageview":"2024-07-30 08:53:36",
"pageviews":null,
"raynet_id":null,
"last_delivery":"2024-08-21 10:12:12",
"since_last_open":null,
"since_last_click":null,
"last_transaction_id":12499,
"last_transaction":"2024-07-24 08:33:18",
"automations":"{\"ended\": [3023, 3222, 3306]}",
"sends_since_open":0,
"sends_since_click":4,
"skips":null,
"attributions":null
},
"subscribers":[
{
"id":6,
"name":null,
"surname":"",
"email":"filounek@ecomail.cz",
"gender":null,
"vokativ":null,
"bounce_soft":0,
"bounce_soft_count":0,
"bounced_hard":0,
"bounce_message":null,
"inserted_at":"2017-11-10 10:34:31",
"last_position":"CZ,Hlavni mesto Praha",
"rating":5,
"pipl":null,
"nameday":null,
"source":"app_form",
"company":null,
"street":null,
"city":null,
"country":"CZ",
"zip":null,
"phone":"+420123456789",
"pretitle":null,
"surtitle":null,
"birthday":null,
"notes":null,
"vokativ_s":null,
"optimized_delivery":null,
"tags":[
"tag1"
],
"webevents":"[{\"label\": \"123456\", \"action\": \"someaction\", \"category\": \"shop\", \"property\": null, \"timestamp\": \"2023-03-15 10:06:31\"}}]",
"last_open":"2024-09-02 14:15:46",
"last_click":"2024-08-05 12:13:28",
"last_pageview":"2024-07-30 08:53:36",
"pageviews":null,
"raynet_id":null,
"last_delivery":"2024-08-21 10:12:12",
"since_last_open":null,
"since_last_click":null,
"last_transaction_id":12499,
"last_transaction":"2024-07-24 08:33:18",
"automations":"{\"ended\": [3023, 3222, 3306]}",
"sends_since_open":0,
"sends_since_click":4,
"skips":null,
"attributions":null
}
]
}account - ID účtu u Ecomailu
pipeline - ID automatizace
action - ID akce
subscribers - pole s JSON objekty uživatelů, jichž se událost týká
Zpracování webhooku pak záleží na jazyku, který používáte. V případě PHP to může být například takto:
$json = json_decode(file_get_contents('php://input'));
Momentálně Ecomail neřeší, zda byl webhook úspěšně zpracován, nebo ne a nechává tuto zodpovědnost na straně zákazníka.