Hoe maak en trigger je een webhook na een opt-in of een verkoop

In dit artikel leer je hoe je een webhook aanmaakt en activeert na een opt-in of een verkoop. De webhookactie verzendt triggergerelateerde gegevens als een HTTP-verzoek in JSON-formaat.

Wat heb je nodig: 

Methode 1:

Ga naar je funnel, selecteer een aanmeldpagina en klik op Automatiseringsregels (1). Klik vervolgens op Regel toevoegen (2).

  1. Stel een webhookbestemming in
Om de regel te testen, kun je een gratis webservice gebruiken zoals RequestBin of Pipedream

(in dit voorbeeld hebben we https://requestbin.net/r/tyhgynty?inspect) gebruikt.

  1. Voeg de bestemmings-URL toe aan het actieveld.

  1. Voer een test-opt-in uit door je aan te melden op je pagina.
  2. Controleer de bestemmingsbron en bekijk de resultaten.

(Voorbeeld: ververs de bestemmingspagina https://requestbin.net/r/tyhgynty?inspect).

Methode 2:

  1. Ga in je systeme.io-account naar Automatiseringen en selecteer Workflows om een nieuwe workflow aan te maken (bijvoorbeeld ‘Webhook verzenden nadat een tag is toegevoegd’).
  2. Stel een webhookbestemming in. Om de regel te testen, kun je een gratis webservice gebruiken zoals requestbin.net (in dit voorbeeld hebben we https://requestbin.net/r/9g4faklz aangemaakt).
  3. Voeg de bestemmings-URL toe aan het actieveld.

Belangrijk: De webhookverzoeken die via systeme.io worden verzonden, komen van de volgende IP-adressen: 185.236.142.1, 185.236.142.2 en 185.236.142.3.

Documentatie webhook-gegevensstructuur

Hieronder vind je voorbeelden van de webhook-gegevensstructuur voor verschillende triggers die worden gebruikt in automatiseringen of workflows:

FUNNEL STAP FORMULIER INGESCHREVEN:

{

"type": "contact.optin.completed",

"data": {

"funnel_step": {

"id": 2102831,

"name": "Squeeze page",

"type": "squeeze",

"funnel": {

"id": 614554,

"name": "webhook data structure documentation"

}

},

"contact": {

"id": 29142804,

"email": "temochkaykvlv+aslkfkvmk@gmail.com",

"fields": [],

"ip": "31.173.103.109",

"referred_by_contact_id": null,

"referred_by_contact_email": null

}

},

"account": {

"email": "temochkaykvlv@gmail.com"

},

"created_at": "2021-10-05T08:10:29+00:00"

}

NIEUWE VERKOOP:

{  "type": "customer.sale.completed",  "data": {    "customer": {      "id": 616824,      "payment_processor": "paypal",      "contact_id": 20756080,      "email": "test-1922@systeme.io",      "fields": {        "country": "FR",        "phone_number": "test-1922",        "street_address": "test-1922",        "first_name": "test-1922",        "surname": "test-1922",        "postcode": "test-1922",        "city": "test-1922"      },      "client_ip": "172.31.31.127"    },    "funnel_step": {      "id": 311,      "name": "Comment cr\\u00e9er un blog qui rapporte",      "type": "offer-form",      "funnel": {        "id": 118,        "name": "Comment cr\\u00e9er un blog qui rapporte"      }    },    "offer_price_plan": {      "id": 19,      "name": "Comment cr\\u00e9er un blog qui rapporte",      "inner_name": "Comment cr\\u00e9er un blog qui rapporte",      "type": "one_shot",      "direct_charge_amount": 583,      "subscription_plan": null,      "currency": "eur"    },    "order": {      "id": 612661,      "created_at": "2021-09-10T14:23:17+00:00"    },    "order_item": {      "id": 763123,      "created_at": "2021-09-10T14:23:17+00:00",      "resources": [        {          "quantity": null,          "enrollment_access_type": null,          "enrollment_dripping_access_course": null,          "type": "systemeio_tag",          "course": null,          "course_bundle": null,          "physical_product": null,          "data": {            "id": 110,            "name": "FR-Client-CCBQR-7"          }        },        {          "quantity": null,          "enrollment_access_type": "full_access",          "enrollment_dripping_access_course": null,          "type": "membership_course",          "course_bundle": null,          "physical_product": null,          "tag": null,          "data": {            "id": 111,            "name": "Formation Un blog qui rapporte",            "description": null          }        }      ]    },    "coupon": null  },  "account": {    "email": "aurelien@readmeimfamous.com"  },  "created_at": "2021-09-10T14:23:33+00:00"}
TAG TOEGEVOEGD:

{  "type": "contact.tag.added",  "data": {    "tag": {      "id": 141002,      "name": "MyAwesomeTag"    },    "contact": {      "id": 29143587,      "email": "temochkaykvlv+lksdllfnsnkfdls@gmail.com",      "fields": [],      "ip": null,      "referred_by_contact_id": null,      "referred_by_contact_email": null    }  },  "account": {    "email": "temochkaykvlv@gmail.com"  },  "created_at": "2021-10-05T09:52:38+00:00"}
TAG VERWIJDERD:

{  "type": "contact.tag.removed",  "data": {    "tag": {      "id": 141002,      "name": "MyAwesomeTag"    },    "contact": {      "id": 27212122,      "email": "temochkaykvlv+test@gmail.com",      "fields": {        "first_name": "Tema test",        "surname": "Testovich"      },      "ip": null,      "referred_by_contact_id": null,      "referred_by_contact_email": null    }  },  "account": {    "email": "temochkaykvlv@gmail.com"  },  "created_at": "2021-10-05T09:54:08+00:00"}
BLOGPAGINA FORMULIER INGESCHREVEN:

{  "type": "contact.optin.completed",  "data": {    "page_model": {      "id": 2643372,      "name": "Home page",      "blog": {        "id": 33665,        "name": "Test blog"      }    },    "contact": {      "id": 29148862,      "email": "temochkaykvlv+sdadk@gmail.com",      "fields": [],      "ip": "31.173.103.109",      "referred_by_contact_id": null,      "referred_by_contact_email": null    }  },  "account": {    "email": "temochkaykvlv@gmail.com"  },  "created_at": "2021-10-05T10:25:23+00:00"}
INGESCHREVEN VOOR HET WEBINAR:

{  "type": "contact.webinar.registered",  "data": {    "webinar": {      "id": 54072,      "duration": "7200",      "funnel_step": {        "id": 2103445,        "name": "Webinar registration",        "type": "webinar_registration",        "funnel": {          "id": 614774,          "name": "webinar funnel"        }      }    },    "contact": {      "id": 29149232,      "email": "temochkaykvlv+wklm@gmail.com",      "fields": [],      "ip": null,      "referred_by_contact_id": null,      "referred_by_contact_email": null    },    "registered_at": "2021-10-05T10:37:06+00:00",    "scheduled_at": "2021-10-05T15:00:00+00:00"  },  "account": {    "email": "temochkaykvlv@gmail.com"  },  "created_at": "2021-10-05T10:37:06+00:00"}
INGESCHREVEN VOOR DE CURSUS:

{  "type": "contact.course.enrolled",  "data": {    "course": {      "id": 44685,      "name": "webhook data structure doc",      "description": null    },    "contact": {      "id": 29150265,      "email": "temochkaykvlv+kek@gmail.com",      "fields": {        "first_name": "name",        "surname": "last name"      },      "ip": null,      "referred_by_contact_id": null,      "referred_by_contact_email": null    },    "access_type": "full_access"  },  "account": {    "email": "temochkaykvlv@gmail.com"  },  "created_at": "2021-10-05T11:12:29+00:00"}
INGESCHREVEN VOOR EEN CURSUSBUNDEL:

{  "type": "contact.course_bundle.enrolled",  "data": {    "course_bundle": {      "id": 6624,      "name": "webhook data structure doc"    },    "contact": {      "id": 27212122,      "email": "temochkaykvlv+test@gmail.com",      "fields": {        "first_name": "Tema test",        "surname": "Testovich"      },      "ip": null,      "referred_by_contact_id": null,      "referred_by_contact_email": null    },    "access_type": "full_access",    "first_active_course": null  },  "account": {    "email": "temochkaykvlv@gmail.com"  },  "created_at": "2021-10-05T15:42:47+00:00"}
CAMPAGNE VOLTOOID:

{   "type": "contact.campaign.finished",    "data": {      "campaign": {        "id": 82393,        "name": "test campaign",        "description": "webhook data structure doc"      },      "contact": {        "id": 29150412,        "email": "temochkaykvlv+luiklas@gmail.com",        "fields": {          "first_name": "sadkl;",          "surname": "dsl;;"        },        "ip": null,        "referred_by_contact_id": null,        "referred_by_contact_email": null      }    },    "account": {      "email": "temochkaykvlv@gmail.com"    },    "created_at": "2021-10-05T15:42:53+00:00"  }

PAGINA BEZOCHT:

{  "type": "contact.page.visited",  "data": {    "funnel_step": {      "id": 2102832,      "name": "Thank You \\/ Download Page",      "type": "opt_in_thank_you_page",      "funnel": {        "id": 614554,        "name": "webhook data structure documentation"      }    },    "contact": {      "id": 29171084,      "email": "temochkaykvlv+asdfg@gmail.com",      "fields": [],      "ip": null,      "referred_by_contact_id": null,      "referred_by_contact_email": null    }  },  "account": {    "email": "temochkaykvlv@gmail.com"  },  "created_at": "2021-10-05T16:29:02+00:00"}
E-MAIL LINK GEKLIKT:

{  "type": "contact.email_link.clicked",  "data": {    "sent_email": {      "id": 1321034,      "subject": "test email webhook"    },    "contact": {      "id": 24431099,      "email": "temochkaykvlv@gmail.com",      "fields": {        "first_name": "Test",        "surname": "Testovich"      },      "ip": null,      "referred_by_contact_id": null,      "referred_by_contact_email": null    }  },  "account": {    "email": "temochkaykvlv@gmail.com"  },  "created_at": "2021-10-07T10:07:08+00:00"}