# Webhook

### Setting up the Integration

{% stepper %}
{% step %}
**Add your Webhook URL**

To set up your Webhook integration, add the link to which Luciq should forward your reports. You can also choose which details get forwarded.
{% endstep %}

{% step %}
**Select products and test**

Select the products that you would like to integrate with, whether Bugs & Crashes or APM, and test your integration so that everything is working smoothly.
{% endstep %}

{% step %}
**Finish and enable forwarding**

All done! Your integration is now set up and ready. From this final page, you can allow automatic forwarding (this can be reconfigured at any time).
{% endstep %}
{% endstepper %}

Below, you can find more details about the JSON payloads that you will receive.

### Crashes' JSON model:

{% code title="JSON" %}

```json
{
    "Exception": "String",
    "Number": "Number",
    "URL": "String",
    "Status": "String",
    "Email": "",
    "Reported At": "String",
    "Location": "String",
    "Device": "String",
    "Memory": "String",
    "Storage": "String",
    "Connectivity": "string",
    "Battery": "string",
    "App Version": "string",
    "Duration": "number",
    "User Data": "String",
    "Console Log": "Text",
    "Luciq Log": "Text",
    "User Steps": "Text",
    "User Attributes": {},
    "Current View": "String",
    "Locale": "en_US",
    "Orientation": "landscape",
    "Screen Size": "String",
    "Density": "string",
    "Image Attachments": []
}
```

{% endcode %}

### Bugs' JSON model:

{% code title="JSON" %}

```json
{
  "Title": "String",
  "Reported At": "String",
  "Email": "String",
  "Private URL": "String",
  "Categories": "String",
  "Tags": "String",
  "App Version": "String",
  "Device": "String",
  "Location": "String",
  "Duration": Integer,
  "Screen Size": "String",
  "Density": "String",
  "User Attributes": {

  },
  "User Data": "String",
  "User Steps": "String",
  "Luciq Log": "String",
  "Console Log": "String",
  "Locale": "String",
  "Image Attachments": [

  ],
  "Non Image Attachments": [

  ],
  "Type": "bug",
  "URL": "String"
}
```

{% endcode %}

### APMs' JSON model:

{% code title="JSON" %}

```json
{
  "title": "String",
  "trace": "String",
  "trigger": "String",
  "trigger_operator": "String",
  "test_value": "Number",
  "duration": "String",
  "conditions": [
    {
      "key": "String",
      "operator": "String",
      "value": "String"
    }
  ],
  "current_value": "String",
  "metric": "String",
  "application": "String",
  "platform": "String",
  "url": "String"
}
```

{% endcode %}

### Using Secret Tokens

Ensure your server is only receiving the expected Luciq requests for security reasons.

{% stepper %}
{% step %}
**Creating a secret**

Create a random alphanumeric secret that’s at least 16 characters and has a maximum of 64 characters.

Here’s a sample secret: `d8yyxj7srjqf5xyih8ay`

Note: please make sure to save this secret.
{% endstep %}

{% step %}
**Bind the secret with Webhooks**

Create a Webhook integration on Luciq then enter the secret you created in the **“Secret token”** field.
{% endstep %}

{% step %}
**Save the integration**

After saving the integration, each request that is sent from this integration will have an extra field in the header called `x-ibg-signature-256`.
{% endstep %}

{% step %}
**Authenticate incoming requests**

Once your server receives the response from Luciq, do the following:

* Hash the response body using the Secret token you created.
* Use the sha256 algorithm for hashing.
* Compare the result of the hash with the header `x-ibg-signature-256`.
  {% endstep %}

{% step %}
**Verify the signature**

* If the results are equal, then it means it’s sent from Luciq.
* If they are not equal, then it’s not sent from Luciq.
  {% endstep %}
  {% endstepper %}


---

# 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.luciq.ai/product-guides-and-integrations/integrations/webhook.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.