Email Integration Webhook Configuration

 

Cet article est actuellement disponible en anglais et en espagnol. Vous pouvez vous servir de cette documentation en attendant qu'elle soit disponible dans votre langue.

To configure Email Webhooks, go to Connectif, Integrations -> Email Integration -> tab Settings.

mceclip0.png

In this tab, there is an advanced configuration section where you can configure the endpoint for:

  • notification of a new subscription
  • notification of a subscription cancellation
  • notification of a bounce.

Notify a new subscription

Connectif will call this endpoint every time a contact subscribes to the newsletter through a sign-up form that has been configured to notify the subscription (this can be configured in the form options).

The request is HTTP GET and will include the following parameters in the query string:

  • email: the email of the contact who has subscribed to the newsletter;
  • ip: the IP address of the contact from which they submitted the subscription form.

Subscription cancellation

Connectif will call this endpoint every time a contact cancels their subscription to the newsletter.

The request is HTTP GET and will include the following parameters in the query string:

  • email: the email of the contact who has unsubscribed;
  • ip: the IP address of the contact from which they clicked on the unsubscribe link.

Note

This webhook is also triggered if the subscription is canceled (marking the newsletter subscription status field with the value unsubscribed) for a contact within Connectif via the contact detail sheet, contact import, or workflow with the set field node. In these cases, the ip parameter will have no value.

Email bounce

Connectif will call this endpoint every time an email sent to a contact results in a bounce of any type.

The POST request with “Content-Type: application/json” sends the following parameters in the body:

Name Description
bounceErrorMessage text with the description of the bounce returned by the mail server to which the email delivery was attempted
bouncestatus bounce code returned by the mail server to which the email delivery was attempted
bounceTypeId type of bounce, the possible values can be: 'hard', 'soft', 'other'
workflowId the ID of the workflow from which the email that caused the bounce was sent
contentId the ID of the content that was sent to the contact
entityId the ID of the contact who bounced
entityEmail the email of the contact who bounced
Cet article vous a-t-il été utile ?
Utilisateurs qui ont trouvé cela utile : 0 sur 0