Ontwikkelaars

Bouw voort op Plixa in enkele minuten.

Plixa is API-first. Genereer een token in het panel, verstuur een bericht via POST en ontvang elk inkomend bericht via ondertekende webhooks. Geen SDK te installeren, geen propriëtair protocol — gewoon JSON, REST en HMAC.

API-toegang is inbegrepen bij de Professional- en Business-abonnementen. Genereer tokens op /api-tokens vanuit het panel.

Verstuur een bericht

Verstuur via POST een telefoonnummer en een tekst. Wij zoeken of openen het gesprek, sturen het naar WhatsApp en geven het bericht in de wachtrij terug.

POST https://api.plixa.app/v1/messages/send

· Vereist een token met de `write`-bevoegdheid.
· Limiet: 100 verzoeken / minuut per token.

Send with curl

curl -X POST https://api.plixa.app/v1/messages/send \
  -H "Authorization: Bearer plixa_pat_…" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "5511999999999",
    "body": "Hi Lucia! Your order shipped"
  }'

Send with Node.js

await fetch('https://api.plixa.app/v1/messages/send', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.PLIXA_TOKEN}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    phone: '5511999999999',
    body: 'Hi Lucia! Your order shipped',
  }),
})

Ontvang elk bericht

Registreer een webhook-endpoint in het panel. Plixa verstuurt via POST elk inkomend bericht (en uitgaand, als je wilt) binnen seconden naar je URL.

Stel je in op https://app.plixa.app/webhooks

· Events: message.inbound, message.outbound, conversation.created, conversation.updated, conversation.deleted.
· Herhaalpogingen: exponentiële backoff (1m, 5m, 30m, 2u, 12u), 5 pogingen in totaal. Een 410 / 4xx-respons stopt de reeks herhaalpogingen.

Verifieer de handtekening

Elke levering bevat een X-Plixa-Signature-header. Hash de ruwe tekst opnieuw met het geheim van je endpoint en vergelijk in constante tijd.

X-Plixa-Signature: sha256=<hmac>

Verify a webhook (Node.js / Express)

import crypto from 'crypto'

app.post('/plixa-webhook', express.raw({ type: 'application/json' }), (req, res) => {
  const expected = 'sha256=' + crypto
    .createHmac('sha256', process.env.PLIXA_WEBHOOK_SECRET)
    .update(req.body)
    .digest('hex')

  const provided = req.header('X-Plixa-Signature') ?? ''
  if (!crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(provided))) {
    return res.status(401).send('bad signature')
  }

  const event = JSON.parse(req.body.toString())
  // event.event, event.data — handle and respond 2xx within 10s.
  res.status(204).end()
})

Verify a webhook (PHP / Laravel)

Route::post('/plixa-webhook', function (Request $request) {
    $body = $request->getContent();
    $expected = 'sha256='.hash_hmac('sha256', $body, env('PLIXA_WEBHOOK_SECRET'));
    if (! hash_equals($expected, (string) $request->header('X-Plixa-Signature'))) {
        abort(401, 'bad signature');
    }

    $event = json_decode($body, true);
    // $event['event'], $event['data'] — handle and respond 2xx in <10s.

    return response()->noContent();
});

Volledige referentie

Elk endpoint (panel + extern) is gedocumenteerd met het schema van het verzoek, voorbeelden en de response-envelopes.

Open de /v1/docs-referentie

Aan de slag

Automatiseer WhatsApp vandaag nog.

Koppel je nummer in vijf minuten en laat AI het eerste antwoord afhandelen. 7 dagen gratis op Professional — geen creditcard, altijd opzegbaar.

Gratis starten Bekijk prijzen

Geen creditcard nodig.