talqo Developer API

Authentifizierung

Authentifizieren Sie Ihre API-Anfragen mit einem API-Schlüssel im X-API-Key Header.

curl -X GET https://api.talqo.dev/api/v1/agents \
  -H "X-API-Key: ab_live_A3xK9mQpR2tVbNcD..." \
  -H "Content-Type: application/json"

Fehler & Rate Limits

HTTP Status Codes

Error-Format

{
  "detail": "Beschreibung des Fehlers"
}

Rate Limits

Die API ist auf 100 Anfragen pro Minute pro API-Schlüssel begrenzt. Bei Überschreitung erhalten Sie den Status 429.

Webhooks

Webhooks ermöglichen es Ihnen, in Echtzeit über Events benachrichtigt zu werden — z.B. wenn ein neuer Lead erfasst oder eine Konversation eskaliert wird.

So funktioniert es

1. 1Erstellen Sie einen Webhook im Dashboard oder per API mit der Ziel-URL und den gewünschten Events.
2. 2talqo sendet bei jedem Event einen HTTP POST mit dem Payload und einer HMAC-SHA256 Signatur.
3. 3Verifizieren Sie die Signatur mit Ihrem Webhook-Secret und verarbeiten Sie das Event.

Signatur-Verifizierung

Jede Zustellung enthält einen X-Webhook-Signature Header. Verifizieren Sie diesen so:

import crypto from 'crypto'
function verifyWebhook(body, signature, secret) {
  const expected = 'sha256=' + crypto
    .createHmac('sha256', secret)
    .update(body)
    .digest('hex')
  return crypto.timingSafeEqual(
    Buffer.from(signature),
    Buffer.from(expected),
  )
}
// In Ihrem Webhook-Handler:
const isValid = verifyWebhook(rawBody, req.headers['x-webhook-signature'], secret)

Verfügbare Events