KiotViet Trigger icon

KiotViet Trigger

Xử lý các sự kiện từ KiotViet thông qua webhook

KiotViet Trigger

AI-generated

Overview

This node acts as a trigger for events from KiotViet via webhooks. It listens for specific events such as customer updates, product updates, order updates, and deletions among others, and triggers workflows in n8n when these events occur. It is useful for automating processes based on real-time changes in KiotViet data, such as updating CRM systems when customer information changes or managing inventory when stock levels are updated.

Use Case Examples

  1. Trigger a workflow when a customer is updated in KiotViet to synchronize customer data with another system.
  2. Trigger a workflow when an order is updated to automate order processing or notifications.
  3. Trigger a workflow when a product is deleted to update product listings in other platforms.

Properties

Name Meaning
Sự Kiện The specific KiotViet event to listen for, such as customer update, product delete, or order update.
Webhook Secret A secret string used to authenticate incoming webhook requests from KiotViet. It should be at least 8 characters long.
Mô Tả Webhook A description for the webhook to identify it.
Bộ Lọc Filters to restrict events to specific branch IDs or statuses.

Output

JSON

  • webhookId - The unique identifier of the webhook event.
  • attemptNumber - The attempt number of the webhook delivery.
  • eventType - The type of event that triggered the webhook.
  • data - The main data payload of the event.
  • rawPayload - The full raw payload received from the webhook.
  • receivedAt - Timestamp when the webhook was received.
  • signatureValid - Boolean indicating if the webhook signature was validated successfully.
  • webhookUrl - The URL of the webhook endpoint in n8n.
  • removedIds - List of IDs removed, applicable for delete events.

Dependencies

  • Requires KiotViet API credentials for authentication.

Troubleshooting

  • Ensure the webhook secret is at least 8 characters long to avoid creation errors.
  • Verify that the webhook URL is accessible from KiotViet to receive events.
  • If webhook signature validation fails, check that the secret matches the one set in KiotViet and that the payload is correctly formatted JSON.
  • Errors during webhook creation or deletion indicate API communication issues; verify API credentials and network connectivity.

Discussion