Entwickler

Baue auf Plixa auf in Minuten.

Plixa ist API-first. Erzeuge ein Token im Panel, sende eine Nachricht per POST und empfange jede eingehende Nachricht über signierte Webhooks. Kein SDK zu installieren, kein proprietäres Protokoll — nur JSON, REST und HMAC.

Der API-Zugang ist in den Tarifen Professional und Business enthalten. Erzeuge Tokens unter /api-tokens im Panel.

Eine Nachricht senden

Sende per POST eine Telefonnummer und einen Text. Wir finden oder öffnen die Konversation, leiten an WhatsApp weiter und geben die eingereihte Nachricht zurück.

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

· Erfordert ein Token mit der `write`-Berechtigung.
· Limit: 100 Anfragen / Minute pro 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',
  }),
})

Jede Nachricht empfangen

Registriere einen Webhook-Endpunkt im Panel. Plixa sendet jede eingehende (und auf Wunsch ausgehende) Nachricht innerhalb von Sekunden per POST an deine URL.

Wird konfiguriert unter https://app.plixa.app/webhooks

· Ereignisse: message.inbound, message.outbound, conversation.created, conversation.updated, conversation.deleted.
· Wiederholungen: exponentielles Backoff (1m, 5m, 30m, 2h, 12h), insgesamt 5 Versuche. Eine 410- / 4xx-Antwort stoppt die Wiederholungskette.

Die Signatur prüfen

Jede Zustellung trägt einen X-Plixa-Signature-Header. Hashe den rohen Text erneut mit dem Secret deines Endpunkts und vergleiche in konstanter Zeit.

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();
});

Vollständige Referenz

Jeder Endpunkt (Panel + extern) ist mit Anfrageschema, Beispielen und Antwort-Hüllen dokumentiert.

Referenz /v1/docs öffnen

Loslegen

Automatisiere WhatsApp noch heute.

Verbinde deine Nummer in fünf Minuten und lass die KI die erste Antwort übernehmen. 7 Tage kostenlos im Professional — keine Kreditkarte, jederzeit kündbar.

Kostenlos starten Preise ansehen

Keine Kreditkarte nötig.