Webhooks

Dokan Cloud offers Webhook Integration. This feature allows you to receive real-time notifications for key events happening in your store. It helps you automate tasks and integrate external applications such as CRMs, inventory management systems, email marketing platforms, and more.

Webhooks are automated messages sent from Dokan Cloud when specific events occur, such as new orders, product updates, or order status changes. These messages are sent to a unique URL (your webhook endpoint), which is set up to receive and process the data.

Supported Events

The following events are supported for webhook notifications in *Dokan Cloud v2.2.3*:

Product Events

• `product.created` – Triggered when a new product is created in your store.
• `product.updated` – Triggered when an existing product is updated.
• `product.deleted` – Triggered when a product is deleted from your store.

Category Events

• `category.created` – Triggered when a new product category is created.
• `category.updated` – Triggered when a product category is updated.
• `category.deleted` – Triggered when a product category is deleted.

Collection Events

• `collection.created` – Triggered when a new collection is created.
• `collection.updated` – Triggered when an existing collection is updated.
• `collection.deleted` – Triggered when a collection is deleted.

Brand Events

• `brand.created` – Triggered when a new brand is created.
• `brand.updated` – Triggered when an existing brand is updated.
• `brand.deleted` – Triggered when a brand is deleted.

These events help you stay up-to-date with changes in products, categories, collections, and brands. You can automate actions based on these updates, such as syncing data with external systems to send notifications or update inventory.

Create Webhooks

To set up webhooks in your Dokan Cloud store, follow the steps below:

Step 1: Access Webhook Settings

1. Log in to your *Dokan Cloud Admin Dashboard*.
2. Navigate to *Integrations → Webhooks*.
3. Click *Manage.*

Step 2: Configure the Webhook

1. Click on the button *"Add Webhook"*.

2. Insert this information to create your Webhook:

• *Endpoint URL*: Provide the unique URL where you want to receive webhook notifications. Ensure the endpoint supports *HTTPS* for secure transmission.
• *Select Events to Subscribe*: Choose the events you want to receive notifications for, such as product updates, category changes, or brand creation.

• *Add*: Click *Add button* to activate the Webhook.

Step 3: Check Webhook Payload

When an event is triggered, Dokan Cloud sends a *POST request* to your webhook URL with a *JSON payload* containing the event data.

*Example Payload for* `product.created` *Event:*

{  "event": "product.created",  "data": {    "product_id": "12345",    "product_name": "Example Product",    "price": "49.99",    "stock_quantity": "100",    "category": "Electronics",    "brand": "BrandName"  },  "timestamp": "2025-07-11T14:32:00Z"}

Step 4: Secure Your Webhook Endpoint

Once you've received the Webhook payload, it’s essential to secure your webhook endpoint to ensure that only Dokan Cloud is sending legitimate data to your system.

1. *Verify the Signature*: Every Webhook request from Dokan Cloud includes a *signature* in the request header. This signature is a hashed value of the payload, and you can use it to verify that the request is authentic.
2. *Implement Signature Validation*: You should validate this signature using a secret key that was generated when you set up the Webhook in your Dokan Cloud Admin Dashboard. You’ll need to compare the received signature with one generated on your server using the same method.

Step 5: Process the Webhook Data

After validating the signature and ensuring the request is legitimate, the next step is to process the webhook data.

For example, if a ` `product.created `` event is triggered, the payload will contain the product’s details (product ID, name, price, stock quantity, etc.). You can then use this data to update your internal systems like *inventory management*, *CRM*, or *email marketing tools*.

Example Action After Receiving Product Data

*CRM Update*: If the event is ` `category.updated ``, you might update your customer records in your CRM system with the new category data.

*Inventory Update*: If the event is `product.created`, you might update your internal inventory system to reflect the new product’s details like stock quantity, price, etc.

*Email Notification*: If you want to notify customers about a new product, you can set up an email marketing tool (like Mailchimp) to automatically send out an email using the product details in the payload.

Step 6: Manage Webhook Events and Configurations

In the *Dokan Cloud Admin Dashboard*, you can manage your webhook settings:

1. *Edit Webhook*: Modify your webhook URL or add/change events.
2. *Delete Webhook*: If you no longer need a specific webhook, you can delete it under the Action.

Dokan Cloud's Webhook Integration allows you to automate store operations and integrate seamlessly with external systems by providing real-time event notifications. This feature is a powerful tool for improving your store’s workflows, automating processes, and syncing data with other platforms.

Последнее изменение: 25/02/2026