Closer
  • Closer guides and FAQ
  • Back to Closer
  • Guide
    • Onboarding
      • Configure your widget
      • Install the widget on your website
      • Invite your team
      • Get the mobile app
      • Advanced Closer widget integration
    • Zacznij używać Closer
      • Przewodnik po platformie
      • Rozmowy
        • Inbox
    • Zarządzaj doradcami
      • Zaproś doradców firmy
      • Ustawienia doradcy
      • Grupuj doradców
    • Skonfiguruj routing
      • Wprowadzenie
      • Dodaj tagi
      • Reguły tagowania
      • Dodaj reguły tagowania
      • Grupuj tagi
      • Ustawienia grupy tagów
    • Getting deeper in dashboard
      • Conversations
        • Inbox
        • Conversation data
    • Getting deeper in widget
      • Widget guides
    • Notifications
    • How to
      • Schedule online meetings
      • Click to call
      • Tagging
      • Proactive messages
      • Set up skill-based routing
      • Manage your team’s workload
      • Force new user everytime in widget
      • User authorization callbacks
      • On deinit callback
      • Identify leads
      • Reports
      • SLA
      • Customer typing preview
      • Push out data with Webhooks
      • Routing
      • Widget OAuth configuration
      • Forms configuration
      • Org configuration API
      • Org configuration fields
      • Configure OMNI integration
      • Elasticsearch business logs
      • Elasticsearch security logs
      • Manage widget button
    • Contact us
    • Supported browsers
    • Upcoming features drafts
      • Business events structure (JSON) - Draft
  • FAQ
    • General
    • Bots
    • Calendar
    • Random
Powered by GitBook
On this page

Was this helpful?

  1. Guide
  2. How to

Push out data with Webhooks

PreviousCustomer typing previewNextRouting

Last updated 5 years ago

Was this helpful?

You can send information from Closer to your application via Webhooks. If you're new to webhooks, read to learn more.

Rather than requiring you to pull information via our API, webhooks will push information to your endpoint. When one of those events is triggered (for example a new deal is added), Pipedrive will send this notification as an HTTP POST request, with a JSON body, to the endpoint(s) you specify.

To configure endpoint(s) for the webhooks to be sent to, head to the section.

We support 2 types of events: conversation.created and conversation.closed.

Webhook format

conversation.created event

{
  "customer": {
    "id": "00000000-0000-0000-0000-000000000000",
    "apiKey": "00000000-0000-0000-0000-000000000000",
    "firstName": "Jon",
    "lastName": "Snow",
    "randomName": "Frosty Wolf",
    "backOfficeData": [
      {
        "key": "currentPage",
        "value": "https://yourbusiness.com/"
      },
      {
        "key": "currentPageTitle",
        "value": "Your business"
      },
      {
        "key": "screenSize",
        "value": "1080x1920"
      },
      {
        "key": "browserVersion",
        "value": "67"
      },
      {
        "key": "browserName",
        "value": "Firefox"
      },
      {
        "key": "operatingSystem",
        "value": "Mac OS X 10.14"
      }
    ]
  },
    "email": "jon.snow@winterfell.com",
    "phone": "+48123456789"
  },
  "timestamp": 1560499664789,
  "eventType": "ThreadCreatedEvent"
}

conversation.closed event


{
  "customer": {
    "id": "00000000-0000-0000-0000-000000000000",
    "apiKey": "00000000-0000-0000-0000-000000000000",
    "firstName": "Jon",
    "lastName": "Snow",
    "randomName": "Frosty Wolf",
    "backOfficeData": [
      {
        "key": "currentPage",
        "value": "https://yourbusiness.com/"
      },
      {
        "key": "currentPageTitle",
        "value": "Your business"
      }
    ],
    "email": "jon.snow@winterfell.com",
    "phone": "+48123456789"
  },
  "timestamp": 1560513840901,
  "closedType": "solved",
  "assignee": {
    "id": "00000000-0000-0000-0000-000000000000",
    "firstName": "Bob",
    "lastName": "Holmes",
    "email": "bob.holmes@closer.app"
    "isBot": false
  },
  "messageHistory": [
    {
      "author": {
        "id": "00000000-0000-0000-0000-000000000000",
        "role": "CUSTOMER",
        "email": "jon.snow@winterfell.com",
        "phone": "+48123456789"
      },
      "message": "Hello",
      "timestamp": 1560177613051
    },
    {
      "author": {
        "id": "00000000-0000-0000-0000-000000000000",
        "role": "ADVISER",
        "email": "bob.holmes@closer.app",
        "phone": null
      },
      "message": "Hi!",
      "timestamp": 1560177614270
    },
    {
      "author": {
        "id": "00000000-0000-0000-0000-000000000000",
        "role": "CUSTOMER",
        "email": "jon.snow@winterfell.com",
        "phone": "+48123456789"
      },
      "message": "Nice to meet you",
      "timestamp": 1560177616949
    }
  ],
  "eventType": "ThreadClosedEvent"
}
this guide
Admin / Webhooks