Skip to main content
ChipChip ROMSYN
Add To Chrome

WebHook

A Personal WebHook empowers you to seamlessly connect your custom software and platforms with ChipChip to automate WhatsApp dispatching. Given our strong emphasis on data privacy, ChipChip’s webhook architecture is built on top of the Google Firebase Realtime Database. This approach leverages Firebase’s generous free-tier allocation while ensuring full sovereignty over your data - meaning zero outbound messages ever transit through our servers.

How It Works

Once configured, you can dispatch an HTTP POST payload from any external application straight to your Firebase instance, and ChipChip handles the delivery in the background.

  • For basic text, the request body can be a straightforward JSON object: 
    { "to" : "99999999999" , "text" : "Hello from ChipChip" }
  • For advanced requirements - such as dispatching multimedia files or rich link previews - you can utilize the built-in Message Builder, which automatically constructs the complex JSON format for you.

Setup Guide

  1. Firebase Initialization

    Set up a project on Firebase and retrieve your Realtime Database URL (Click here for a quick tutorial).

  2. ChipChip Configuration

    Open your ChipChip webhook settings, paste your Firebase Realtime URL, and specify your designated store identifier (the default is chipchip).

  3. Advanced Parameters

    • Callback Url: An optional destination endpoint to receive automated HTTP POST delivery results.
    • Clear messages before start: Automatically purges any legacy queue items currently sitting in Firebase prior to launch.
    • Auto Start: If enabled, the webhook will automatically resume its listening state whenever WhatsApp Web reloads, provided it was active during your previous session.
    • Message Interval: Defines a customized time delay between sequential message dispatches.
    ChipChip webhook settings: Firebase Realtime URL, store, optional callback, clear before start, auto-start, and wait 20 seconds between messages

  4. Activation

    Turn on your webhook. Upon successful startup, you will see a confirmation screen. Your unique ChipChip endpoint URL will be:

    https://<firebase realtime url>/<firebase store>/send.json

    Click the copy button to grab this URL, which serves as the destination for your outbound POST requests.

    ChipChip webhook running: listening URL with copy button, activity log, and Stop in the tab bar

  5. Message Builder

    Compose rich payloads containing text, emojis, files, and link previews using the Message Builder. It generates ready-to-use JSON and supports dynamic field tags for smooth configuration across various third-party stacks.

Additional Requirements & Integrations

  • Important: Running the ChipChip webhook requires your computer to stay powered on and actively running the extension. Make sure to configure your system to prevent entering “Sleep Mode”.

Examples

Send Message

HTTP POST, JSON

{ "to": "99999999999", "text": "Hello from ChipChip" }

RESPONSE

{ "name": "CcQ7xK2m9p" }

Callback

HTTP POST/OPTIONS, JSON

{ "id": "CcQ7xK2m9p", "sent": true, "time": "14:30, 15.03.2026" }

HTTP POST/OPTIONS, JSON

{ "id": "CcQ7xK2m9p", "sent": false, "time": "14:30, 15.03.2026", "reason": "chat_not_found" }

CORS Configuration for Callbacks

Your callback receiving script must support CORS for both POST and OPTIONS (preflight) requests:

header('Access-Control-Allow-Origin: *');
header('Access-Control-Allow-Methods: POST, OPTIONS');
header('Access-Control-Allow-Headers: Content-Type');