integrations

Setting up Vero's Webhooks

Webhook Types

Vero provides webhooks for the following events:

Sent (email has been sent by Vero)
Delivered (email has been delivered to the recipient email server)
Opened
Clicked
Bounced (hard and soft)
Converted
Unsubscribed
Resubscribed
User created
User updated
Complained

Webhook Setup

All of Vero’s webhooks are sent to a single notification address. To enable the webhooks, go to Settings > Integrations > Webhooks and enter the URL at which you wish to receive the webhooks.

vero.settings.integrations.webhooks

For testing, you should check out Request Bin - it’s a fantastic way to see the webhooks Vero (or any service) sends.

You can click the Test URL button and Vero will send an example of a webhook to the URL you’ve entered. This ensures Vero has registered the URL correctly and data arrives.

Once you have entered the URL you can choose which webhook events you want to track.

Webhook format

Webhooks structure for email events

The follow list outlines each of the type values:

sent – When an email has been sent by Vero
delivered – When an email has been delivered to the ISP server
opened – When a customer has opened an email
clicked – When a customer has clicked an email
bounced – When an email has not been delivered to the ISP server
converted – When a customer has converted on an email campaign
resubscribed– When a customer has resubscribed
unsubscribed – When a customer has unsubscribed
complained – When a customer complains through their email client

Sent:

    {
        "sent_at":1435016238,
        "type":"sent",
        "user": {
            "id":123,
            "email":"steve@getvero.com"
        },
        "campaign": {
            "id":987,
            "type":"transactional",
            "name":"Order confirmation",
            "group": "Order confirmation - Email 6",
            "channel": "email",
            "subject":"Your order is being processed!",
            "trigger-event":"purchased item",
            "permalink":"http://app.getvero.com/view/1/341d64944577ac1f70f560e37db54a25",
            "variation":"Variation A"
        },
        "message_id": "20190730123456.1.1B72E094173067F0F@veromail.com"
    }

Delivered:

    {
        "delivered_at":1435016238,
        "type":"delivered",
        "user": {
            "id":123,
            "email":"steve@getvero.com"
        },
        "campaign": {
            "id":987,
            "type":"transactional",
            "name":"Order confirmation",
            "group": "Order confirmation - Email 6",
            "channel": "email",
            "subject":"Your order is being processed!",
            "trigger-event":"purchased item",
            "permalink":"http://app.getvero.com/view/1/341d64944577ac1f70f560e37db54a25",
            "variation":"Variation A"
        },
        "message_id": "20190730123456.1.1B72E094173067F0F@veromail.com"
    }

Opened:

    {
        "opened_at":1435016238,
        "user_agent":"Mozilla/5.0 (compatible; MSIE 9.0; Windows NT 6.1; Trident/5.0)",
        "type":"opened",
        "user": {
            "id":123,
            "email":"steve@getvero.com"
        },
        "campaign": {
            "id":987,
            "type":"transactional",
            "name":"Order confirmation",
            "group": "Order confirmation - Email 6",
            "channel": "email",
            "subject":"Your order is being processed!",
            "trigger-event":"purchased item",
            "permalink":"http://app.getvero.com/view/1/341d64944577ac1f70f560e37db54a25",
            "variation":"Variation A"
        },
        "message_id": "20190730123456.1.1B72E094173067F0F@veromail.com"
    }

Clicked:

    {
        "clicked_at":1435016238,
        "user_agent":"Mozilla/5.0 (compatible; MSIE 9.0; Windows NT 6.1; Trident/5.0)",
        "type":"clicked",
        "user": {
            "id":123,
            "email":"steve@getvero.com"
        },
        "campaign": {
            "id":987,
            "type":"transactional",
            "name":"Order confirmation",
            "group": "Order confirmation - Email 6",
            "channel": "email",
            "subject":"Your order is being processed!",
            "trigger-event":"purchased item",
            "permalink":"http://app.getvero.com/view/1/341d64944577ac1f70f560e37db54a25",
            "variation":"Variation A"
        },
        "message_id": "20190730123456.1.1B72E094173067F0F@veromail.com"
    }

Bounced:

    {
        "bounced_at":1435016238,
        "bounce_type":"hard",
        "type":"bounced",
        "user": {
            "id":123,
            "email":"steve@getvero.com"
        },
        "campaign": {
            "id":987,
            "type":"transactional",
            "name":"Order confirmation",
            "group": "Order confirmation - Email 6",
            "channel": "email",
            "subject":"Your order is being processed!",
            "trigger-event":"purchased item",
            "permalink":"http://app.getvero.com/view/1/341d64944577ac1f70f560e37db54a25",
            "variation":"Variation A"
        },
        "message_id": "20190730123456.1.1B72E094173067F0F@veromail.com"
    }

Converted:

    {
        "type":"converted",
        "user": {
            "id":123,
            "email":"steve@getvero.com"
        },
        "campaign": {
            "id":987,
            "type":"transactional",
            "name":"Order confirmation",
            "group": "Order confirmation - Email 6",
            "channel": "email",
            "subject":"Your order is being processed!",
            "trigger-event":"purchased item",
            "permalink":"http://app.getvero.com/view/1/341d64944577ac1f70f560e37db54a25",
            "variation":"Variation A"
        },
        "message_id": "20190730123456.1.1B72E094173067F0F@veromail.com"
    }

Resubscribed:

    {
        "type": "resubscribed",
        "user": {
            "id": 123,
            "email": "steve@getvero.com"
        }
    }

Unsubscribed:

    {
        "unsubscribed_at":1435016238,
        "type":"unsubscribed",
        "user": {
            "id":123,
            "email":"steve@getvero.com"
        },
        "campaign": {
            "campaign_title": "Order confirmation",
            "series_title": "Order Tracking",
            "channel": "email",
            "message_id": "20190730123456.1.1B72E094173067F0F@veromail.com",
            "email_subject": "Your order is being processed!",
            "variation_name": "Control",
            "template": "Order Template"
        },
    }

Key things to note:

The trigger-event value will be present for Transactional and Behavioral campaigns and represents the event that triggered the campaign.

Webhook structure for customer updates

The webhook sent when a customer is created or updated shows the details of that customer or the changes made to that customer’s properties or their tags. This allows you to update customer details in other systems, based on changes sent to Vero, keeping everything in sync.

User created:

    {
        "type":"user_created",
        "user": {
            "firstname":"Steve",
            "company":"Vero",
            "role":"Bot",
            "id":123,
            "email":"steve@getvero.com"
        }
    }

User updated:

    {
        "action": "user_updated",
        "type":"user_updated",
        "user": {
            "id":123,
            "email":"steve@getvero.com"
        },
        "id": "123",
        "email": "steve@getvero.com",
        "changes": {
            "_tags": {
                "add": ["active-customer"],
                "remove":["unactive-180-days"]
            }
        }
    }

If you have any other questions regarding setting up webhooks, please write us an email. We’re here to help.

Didn't find what you were looking for?

Get in touch, we're always happy to help. Email us at support@getvero.com.