Integrations / GoHighLevel

GoHighLevel logo

CRM & ERP · Workflow webhook action

GoHighLevel + Sendjade

Trigger WhatsApp messages from CRM workflows when contacts move through your pipeline.

Works with the live API

What you can automate

  • Send a booking confirmation when an appointment is created
  • Follow up when an opportunity enters a stage
  • Send an invoice PDF after payment

Before you start

  • A Sendjade account with a connected instance (status Authorized). See Getting started.
  • Your **idInstance** (shown on the instance page in the console) and **apiTokenInstance** (shown once when you created the instance; press Generate new token if you lost it). Use a spare number while testing.
  • A GoHighLevel workflow with the **Webhook** action available.

Set it up

  1. Add the Webhook action

    In a workflow add Webhook, method POST, and paste your instance URL. If your plan lets you send a custom JSON body, you can call Sendjade directly; otherwise use the relay in step 3.

    URL
    https://api.sendjade.com/waInstanceYOUR_ID_INSTANCE/sendMessage/YOUR_API_TOKEN_INSTANCE
  2. Map the contact fields

    Send the phone and message using GoHighLevel merge fields.

    Webhook body
    {
      "chatId": "{{contact.phone}}",
      "message": "Hi {{contact.first_name}}, your appointment is confirmed."
    }
  3. Or host the relay (optional)

    If the body shape is fixed, or you do not want the token inside the CRM, run this small relay. It adds the instance id and token and an idempotency key from its own environment, and you call it with a shared secret instead. It expects to, text and an optional ref.

    relay.mjs
    // relay.mjs: a tiny server for tools that cannot build the JSON body (or that you do not want holding the token).
    // Run it anywhere you can host Node 20+ (a VPS, Render, Fly.io). Keep SENDJADE_* and RELAY_SECRET in its environment.
    import express from 'express';
    
    const app = express();
    app.use(express.json());
    
    app.post('/send', async (req, res) => {
      if (req.query.secret !== process.env.RELAY_SECRET) return res.sendStatus(401); // shared secret in the URL
      const { to, text, ref } = req.body;
      if (!to || !text) return res.status(400).json({ error: 'to and text are required' });
      const r = await fetch('https://api.sendjade.com/waInstance' + process.env.SENDJADE_ID_INSTANCE + '/sendMessage/' + process.env.SENDJADE_TOKEN_INSTANCE, {
        method: 'POST',
        headers: { 'Content-Type': 'application/json', ...(ref && { 'Idempotency-Key': String(ref) }) },
        body: JSON.stringify({ chatId: String(to).replace(/\D/g, ''), message: text }),
      });
      res.status(r.status).send(await r.text());   // 200 { "idMessage": "..." } = accepted for sending
    });
    
    app.listen(8080);

Test it

Add yourself as a contact with your own number and run the workflow with **Test workflow**.

Troubleshooting

The phone is not in international format

Use a custom value or a code step to normalise numbers to <country code><number> with digits only before sending.

I get 401 unauthorized

The idInstance or token in the URL is wrong. Copy both again from the console. Generating a new token makes the old one stop working immediately.

I get 409 instance_not_connected

The instance is not Authorized yet. Open it in the console, press Connect and scan the QR code.

I get 400 invalid_chat_id

Use international format with digits only, e.g. 2348012345678 (or 2348012345678@c.us). Remove spaces, dashes and the leading zero of the local number.

I get 422 recipient_opted_out

That person replied STOP (or was added to the opt-out list). Sendjade refuses to message them. Remove the number from Opt-outs only if they asked to hear from you again.

I get 429 daily_limit_reached or rate_limited

The number reached its 24-hour sending cap (default 500) or you are calling too fast. The cap protects your number from restriction. Slow down, and raise the cap only if your volume is genuine.

Ask AI to help me integrate GoHighLevel

Copy this prompt into ChatGPT, Claude or any assistant. It already knows Sendjade’s API, so the answer matches our endpoints.

The prompt is plain text that you copy yourself. Never paste real keys into an assistant; use placeholders.