Un Webhook est un rappel d'événement, utilisé par des applications distantes pour recevoir des notifications d'événements de Symplify. Les événements seront envoyés à l'URL fournie. Depuis l'une des IP suivantes, selon le serveur de votre compte Symplify :
- SERVEUR UN – 192.165.55.111
- SERVEUR DEUX – 192.165.55.112
- SERVEUR TROIS – 192.165.55.113
- SERVEUR CINQ – 184.107.113.20
Vous pouvez mettre en place des Webhooks pour :
- Bounce – adresse email rebondie
- Formulaire soumis - données soumises dans un formulaire sur une page web dynamique
- Mise à jour de l'utilisateur final - propriété de l'utilisateur final mise à jour via la fonction de clic sur le lien
- Lien cliqué - n'importe quel lien est cliqué
- Courriel ouvert - courriel ouvert
- Désabonnement - clique sur le lien de désabonnement
- SMS Inbox - enregistrement du numéro de téléphone entrant
- Optin - Destinataire créé via le formulaire Symplify Optin.
- Propriété définie - le contact a été mis à jour en cliquant sur le lien dans le courriel.
- Sommaire d'envoi - informations sur un envoi déclenché lors de la livraison (uniquement pour les envois traités par lots)
Configuration
Créez le(s) point(s) d'extrémité (endpoints) de votre côté (ils doivent être gérés de manière asynchrone).
Lorsque vous avez créé des points d'extrémité de webhook de votre côté, vous pouvez les ajouter aux webhooks que vous souhaitez utiliser.
Cliquez sur Modifier pour l'événement que vous souhaitez recevoir et collez votre point de terminaison, puis cliquez sur Enregistrer.
Exemples
Les données qui seront envoyées via Webhook depuis Symplify sont les suivantes, à partir de quelques exemples.
Courriel ouvert
{"listId":6862,"eventId":421213691,"contactId":"ORIGINALID123","campaignId":310216,"sentTimestamp":"2015-06-29T11:07:49.913+02:00","carmaContactId":78605652,"campaign":"Campaign_10","project":"Newsletter","description":"MailOpened","list":"DatabaseCOM","projectId":4,"timestamp":"2015-06-29T11:07:49.913+02:00"}
Lien cliqué
{"eventId":421213692,"contactId":"ORIGINALID123","campaignId":310216,"linkTarget":"http://www.example.com?new_parameter=example_placeholder¶meter_name=parameter_value&mallgroda=2&skorpgrus=yes&slang=hallon",
"project":"Newsletter","clickTimestamp":"2015-06-29T11:11:07.297+02:00","description":"ClickedLink","list":"DatabaseCOM","listId":6862,"carmaContactId":78605652,"campaign":"Campaign_1","projectId":4,"timestamp":"2015-06-29T11:11:07.297+02:00"}
Opt out (Désabonnement)
{"eventId":421213698,"contactId":"ORIGINALID123","campaignId":310217,"module":"CAMPAIGN","channel":"SMS","project":"Newsletter","description":"OptOut",
"list":"DatabaseCOM","listId":6862,"carmaContactId":78605652,"campaign":"Campaign_1","comment":null,"projectId":4,"unsubscribeTimestamp":"2022-06-29T11:29:35.797+02:00","timestamp":"2022-06-29T11:29:35.797+02:00"}
Rebond
{"eventId":1544584357,"bounceStatusCode":"5.7.1 (delivery not authorized)","contactId":"123456","bounceType":1,"campaignId":310216,"bounceTimestamp":"2017-01-11","project":"Account","bounceDomain":"example.com","description":"Bounce","bounceMessage":"relaying-issues","list":"Email verification","bounceRecipient":"123456","listId":19350,"carmaContactId":xxxxxxxxx,"campaign":"Campaign_1","projectId":7656,"timestamp":"2017-01-11T09:00:28.063+01:00"}
Formulaire soumis
{"customerId":1001,"micrositeId":646,"microsite":"Preferences","siteType":"DEFAULT","pageId":1,"page":"Landing page","projectId":1142,"project":"Automations COM","listId":17717,"list":"DatabaseCOM","originalId":"123456","data":{"gdpr_consent":"true","frequency":"weekly"},"timestamp":1698220840114,"messageType":"FORM_SUBMITTED"}
Utilisateur mis à jour
{“listId”:23481,“eventId”:503916682,“contactId”:“123456”,“property”:“city”,“carmaContactId”:421497130,“listName”:”DatabaseCOM”,“value”:“london”}
Optin
{"listId":23610,"eventId":503965015,"contactId":"123456","carmaContactId":421506676,"description":"OptIn","list":"DatabaseCOM","timestamp":"2017-11-22T16:04:04.063+01:00"}
SMS Inbox
{“timestamp”: “2018-04-03T13:20:15.413+02:00″, “message”: “stop”, “sender”: “467123456789″, “shortCode”: 72456, “eventId”: 1986037821, “listId”: 42261, “description”: “SmsInbox”, “keyword”: “STOP”, “originalId”: “123456”, “sentTimestamp”: “2018-04-03T13:20:15.413+02:00”, “country”: “se”}
Propriété définie
{"listId": 31391, "eventId": 1535568871, "messageType": "SET_PROPERTY", "contactId": "7b1a895d-2a43-4e29-0a18-aa52147e70c7", "property": "contact.title", "carmaContactId": 663829901, "listName": "jesper@compost.se", "value": "Updated by email click"}
Sommaire d'envoi
{"eventId": 513337426, "campaignId": 1011835, "subjects": [{"content": "Subject line to all members","segmentId": 9919,"segment": "Members"},{"content": "Subject line to the rest","segmentId": -10,"segment": "Everyone"}],"channel": "EMAIL","project": "Newsletter","list": "My database","type": "SINGLE_STEP","sentCount": 11000,"listId": 240023,"messageType": "SENDOUT_SUMMARY","segment": "Swedish customers","segmentId": 10599,"replyTo": "Company name (hello@example.com)","campaign": "WEEK15","from": "Company name (hello@example.com)","projectId": 11462,"timestamp": 1680507950167}}