Manage Outgoing WebHooks for Contacts

Create an Outgoing Webhook for Polaria

Steps to Configure:

1. Access the App Settings:

   • Log in to your Polaria account.

   • Click on Apps or navigate to the Apps section.

2. Find and Configure the Webhooks App:

   • Search for "Custom Webhooks".

   • Click on "Configure this app".

3. Set up the Endpoint:

   • Add your Endpoint URL.

   • Save the configuration.

   • Polaria will send a test webhook to this URL, which includes your unique Webhook Security Token to authenticate requests from Polaria servers.

Event Examples:

Test Event

This event verifies that the webhook endpoint is functioning correctly.

{
  "event": "test",
  "token": "a-unique-token"
}

Contact Updated Event

Triggered when contact details are updated.

{
  "event": "contact_updated",
  "token": "a-unique-token",
  "payload": {
    "contact": {
      "token": "7d50f7d5-66d9-423c-b442-458d02a3fe60",
      "name": "Remi Delhaye",
      "email": "[email protected]",
      "language": "en-US",
      "last_visited_page": "polaria.ai",
      "platform": "OS X (10.11.6)",
      "browser": "Chrome (52.0.2743.116)",
      "city": "San Francisco, CA",
      "country": "US",
      "referrer": "https://google.com",
      "pages_visited_count": 42,
      "custom": {
        "user_id": 123456789,
        "firstname": "Rémi",
        "lastname": "Delhaye",
        "team_id": 1
      }
    }
  }
}

Key Fields:

• event: Specifies the event type (test, contact_updated).

• token: A unique security token to validate the webhook source.

• payload: Contains details about the event. For contact updates:

  • contact: Detailed information about the updated contact, including:

    • General Info: name, email, language, last_visited_page.

    • Device Info: platform, browser.

    • Location: city, country, referrer.

    • Custom Data: Additional fields like user_id, firstname, lastname, team_id.

This setup ensures secure and real-time updates for custom integrations using Polaria webhooks.