# Webhook Integration

1\. Sample Payload for event (widget new conversation) :-

&#x20;Below is the sample payload for one of our webhook event and it has lots of data in it but to get only the required lead data you just need to follow below sequence to map fields at your end to capture.\
\
**payload.people\_detail.name**\
**payload.people\_detail.mobile\_number**\
**payload.people\_detail.email   and so on…**&#x20;

&#x20;**OVERALL MASTER PAYLOAD** :-  (highlighted the LEAD data in it)

```
{
    "event_type": "widget_new_conversation",
    "payload": {
      "message_content": "6380dc9b-3af9-4362-b7b1-32d47c13df4f",
      "message_type": "schedule_meeting",
      "message_from": "9d438aaa-1eaa-496a-a8b3-b4f98367bb0d",
      "meta": [
        {
          "moderators": [
            "chetan@saleassist.ai",
            "8373916383"
          ],
          "participants": [
            "+918765875687"
          ],
          "date": "7/11/2024",
          "time": "04:30 PM",
          "timezone": "Asia/Calcutta",
          "duration": 30,
          "duration_mode": "min",
          "watermark": "https://static.saleassist.ai/icons/saleassist-icon-black.png",
          "rrule": "",
          "registration_enabled": false,
          "products_enabled": false,
          "registration_form": "[{\"type\":\"paragraph\",\"subtype\":\"p\",\"label\":\"Please fill in your details to register\",\"access\":false},{\"type\":\"text\",\"required\":true,\"label\":\"Name\",\"placeholder\":\"Enter your name\",\"className\":\"form-control\",\"name\":\"name\",\"access\":false,\"subtype\":\"text\"},{\"type\":\"text\",\"required\":true,\"label\":\"Email\",\"placeholder\":\"Enter your email\",\"className\":\"form-control\",\"name\":\"email\",\"access\":false,\"subtype\":\"text\"},{\"type\":\"text\",\"required\":false,\"label\":\"Mobile number\",\"placeholder\":\"Enter your mobile number\",\"className\":\"form-control\",\"name\":\"mobile_number\",\"access\":false,\"subtype\":\"text\"}]",
          "capture_registration_otp_params": false,
          "registration_otp_params": "email",
          "unique_field_name": "email",
          "is_recurring": false,
          "auto_record": true,
          "end_recurring": 0,
          "room_name": "",
          "meeting_name": "Meeting with +918765875687",
          "description": "",
          "meeting_password": "",
          "meeting_type": "live_call",
          "can_co_browse": true,
          "channels": [],
          "widgets": [],
          "products": [],
          "products_listing_mode": "buy",
          "is_moderated_chat": false,
          "moderation_mode": "auto_censored",
          "moderated_keywords": [],
          "pinned_messages": [],
          "thumbnail": "",
          "id": "6380dc9b-3af9-4362-b7b1-32d47c13df4f",
          "created_by_user_id": "a184afcd-6d05-4052-a156-4c057ce723e8",
          "recording_url": "",
          "events": [],
          "tokens": {},
          "recurring_batch_id": "",
          "start_time": 0,
          "end_time": 0,
          "run_time": 0,
          "recording_time": 0,
          "streaming_time": 0,
          "cumulative_participant_time": 0,
          "billing_cumulative_participant_time": 0,
          "scheduled_time": 1720695600000,
          "meeting_status": "SCHEDULED",
          "participant_count": 0,
          "active_participant_count": 0,
          "public_session_count": 0,
          "co_browsing_time": 0,
          "client_id": "74c28198-7762-40d3-8925-5cc00dc99e98",
          "notify_meeting_participants": {
            "first": false,
            "second": false
          },
          "co_browsings": [],
          "recordings": [],
          "streamings": [],
          "participant_durations": {},
          "host_room": "82dcc3da-8f70-45fb-ac26-c265af7838f4",
          "view_room": "81f54c1b-664f-460c-8add-e4dabdf2da3f",
          "external_id": "6380dc9b3af94362b7b132d47c13df4f",
          "provider": "",
          "created_on": 1720694557992,
          "updated_on": 1720694558015,
          "source_referrer": "https://jump.saleassist.ai/jump/905002c3-9be6-43fa-8e3d-e71ab0c1d1b7",
          "uid_map": {},
          "followed_up": false,
          "confirmed_at": 0,
          "picked_up_at": 0,
          "participant_exit_times": [],
          "date_time": "2024-07-11T16:30",
          "date_time_ist": "2024-07-11T16:30"
        },
        {
          "message": ""
        }
      ],
      "raw": {},
      "acknowledged": false,
      "is_bot_handover": false,
      "message_to": "a184afcd-6d05-4052-a156-4c057ce723e8",
      "people_id": "9d438aaa-1eaa-496a-a8b3-b4f98367bb0d",
      "meeting_id": "6380dc9b-3af9-4362-b7b1-32d47c13df4f",
      "form_id": "bda6d00a-adf7-409e-8c93-ec08698d0aac",
      "unique_field_value": "+918765875687",
      "source_id": "905002c3-9be6-43fa-8e3d-e71ab0c1d1b7",
      "source_name": "FNP Button test",
      "source_type": "live_call",
      "source_referrer": "https://jump.saleassist.ai/jump/905002c3-9be6-43fa-8e3d-e71ab0c1d1b7",
      "session_id": "e8ebb379-75a9-41e5-8a14-9f8f0842830f",
      "whatsapp_request_id": "",
      "whatsapp_status": {},
      "chat_group_id": "",
      "id": "dc60de93-d726-43cc-ad06-9cc7544cb8e5",
      "is_moderated": false,
      "is_handover_question": false,
      "client_id": "74c28198-7762-40d3-8925-5cc00dc99e98",
      "created_on": 1720694558068,
      "updated_on": 1720694558068,
      "dropped_at": 0,
      "people_detail": {
"name": "Prakash Mudhaliyar",
 "mobile_number": "+910987654321",
 "email": "prakashm@athenabpo.in",
 "address": "Thane",
 "pincode": "400615",
 "utm_campaign": "Test",
 "date_of_month": "28",
  "time_of_day": "15:00",
 "day_of_week": "4",
  "month_of_year": "2022",
  "originated_from": "Test",
  "product_category": "Water Purifier",
  "product_sku": "Test",
  "device": "Mobile",
  "form_fill": "Test",
  "otp_verified": "Yes",
  "extra1": "N1",
  "extra2": "N1",
   "widget_city": "Faridabad",
   "widget_state": "Haryana",
    "widget_country": "India",
    "widget_latitude": 28.4098,
    "widget_longitude": 77.31,
    "widget_ip_address": "103.201.143.23",
    "widget_location_source": "IP ADDRESS"
          "id": "9d438aaa-1eaa-496a-a8b3-b4f98367bb0d"
      },
      "meeting_url": "https://meet.saleassist.ai/82dcc3da-8f70-45fb-ac26-c265af7838f4?user_identity=+918765875687"
    },
    "metadata": {}
  },
  "headers": {
    "content-length": "4482",
    "cdn-loop": "cloudflare",
    "cf-ipcountry": "IN",
    "cf-ray": "8a18301c984c4841-BOM",
    "x-forwarded-proto": "https",
    "x-forwarded-port": "443",
    "x-forwarded-for": "34.93.136.15",
    "accept": "*/*",
    "x-amzn-trace-id": "Root=1-668fb71e-58ab68ae3a48491217fcec09",
    "cf-visitor": "{\"scheme\":\"https\"}",
    "host": "automation.quickwork.co",
    "connection": "close",
    "content-type": "application/json; charset=UTF-8",
    "cf-connecting-ip": "34.93.136.15",
    "accept-encoding": "gzip, br",
    "user-agent": "python-requests/2.31.0"
  },
  "queryString": {}
}
```

**Total Available Webhook Events :-**

<figure><img src="/files/GgVJFriU5sdwmA2YOxAR" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/JpfLCzarL9RavqV0dEwJ" alt=""><figcaption></figcaption></figure>

**Enable Webhooks in Dashboard :-**

2. Login to dashboard <https://my.saleassist.ai>

<figure><img src="/files/Bc4D1r3vCx2UW1j8cuud" alt=""><figcaption></figcaption></figure>

3. Go to Settings -> API -> Webhooks

<figure><img src="/files/VTBukzbnjpywtj6vQM8Y" alt=""><figcaption></figcaption></figure>

4. Select Webhook event to configure.

<figure><img src="/files/nYbrAp5mUDIsgw4fcCRh" alt=""><figcaption></figcaption></figure>

5. Add POST URL, Enable and Save it.

<figure><img src="/files/M9h7LmlPxVlEhezN30hF" alt=""><figcaption></figcaption></figure>

6. Once webhooks are enabled, please check Audit logs to confirm.

<figure><img src="/files/1JvuQZ2vh2e7esu1RfbW" alt=""><figcaption></figcaption></figure>

It’s done.

3. Go to Settings -> API -> Webhooks - mapping<br>

   <figure><img src="/files/YANnvIT0jgnJYWebd2ky" alt=""><figcaption></figcaption></figure>

4. Now select the widget and then clink on Get Schema.<br>

   <figure><img src="/files/jZQNnuWyFmygD8B6S5ta" alt=""><figcaption></figcaption></figure>

5. Now create mapping by clicking on + icon and select the fields which you wish to choose.<br>

   <figure><img src="/files/ptnHbBwVyAvUR1NICVsO" alt=""><figcaption></figcaption></figure>

6. Once you select the fields, click on the save mappings.<br>

   <figure><img src="/files/TVSMHuwoVewcPwQNAQLG" alt=""><figcaption></figcaption></figure>

7. Now add the key and value in the custom headers and add the post call URL and click on Create Webhook.

   <figure><img src="/files/BctWJjOFZ2VPCsVlbvUQ" alt=""><figcaption></figcaption></figure>

   And it's done.

&#x20;**WEBHOOK DOCUMENTATION REFERNCE:-**

{% embed url="<https://platform.saleassist.ai/redoc#tag/webhooks>" %}

&#x20;*For more details and support, please write us at **<support@saleassist.ai>***


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.saleassist.ai/integration-guide/webhook-integration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
