Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.vultlocal.com/llms.txt

Use this file to discover all available pages before exploring further.

Webhooks allow external systems to push event notifications to OLIVE. These endpoints receive payment confirmations, message events, and other real-time updates.

Features

VULT Integration

Receive cash-in notifications from VULT processor

WhatsApp Messages

Process WhatsApp messages via Agent-TS

HMAC Verification

Secure webhook payloads with signature verification

Real-time Processing

Instant event handling and response

Endpoints

VULT Webhook

POST /webhooks/vult/cashinReceive VULT cash-in notifications

WhatsApp Webhook

POST /api/v1/external/whatsappProcess WhatsApp messages

Webhook Security

All webhooks should verify the signature before processing:
  1. Extract signature from header (X-Webhook-Signature or equivalent)
  2. Compute HMAC-SHA256 of the raw request body
  3. Compare signatures using timing-safe comparison
  4. Reject requests with invalid or missing signatures

Webhook Flow

1

Event Occurs

External system (VULT, WhatsApp) generates an event
2

Webhook Sent

System sends HTTP POST to configured endpoint with signed payload
3

Verify Signature

OLIVE verifies HMAC signature before processing
4

Process Event

Event is processed (e.g., credit wallet, respond to message)
5

Acknowledge

Return success response to confirm receipt