Aller au contenu
Documentation · Webhooks

Pour les développeurs

Webhooks

Parlo envoie un POST JSON signé à votre serveur à chaque retour analysé : pour alimenter votre outil interne, Slack, Zapier ou votre CRM.

Configurer

Paramètres → Webhook : saisissez une adresse en https://. Parlo génère un secret de signature (whsec_…). Le bouton « Envoyer un test » envoie un événement test, et le journal montre les 20 derniers envois.

Requête

En-têteValeur
Content-Typeapplication/json
X-Parlo-Eventfeedback.analyzed ou test
X-Parlo-Signaturesha256= suivi du HMAC-SHA256 du corps brut, en hexadécimal
User-AgentParlo-Webhook/1
JSON
{
  "event": "feedback.analyzed",
  "createdAt": "2026-11-12T10:42:00.000Z",
  "data": {
    "id": "8f3c…",
    "site": { "id": "…", "name": "Acme" },
    "intent": "feedback",
    "kind": "audio",
    "summary": "L'export PDF des factures tourne sans fin",
    "type": "bug",
    "sentiment": "negative",
    "text": "Bonjour, j'ai essayé d'exporter mes factures…",
    "language": "fr",
    "durationMs": 47000,
    "pageUrl": "https://app.acme.fr/factures",
    "device": "Ordinateur · macOS · Chrome",
    "endUserId": "u_123",
    "endUserName": "Camille",
    "identity": "verified",
    "contactEmail": "camille@exemple.fr",
    "context": { "plan": "pro" },
    "appVersion": "2.4.1",
    "isTest": false,
    "hasScreenshot": true,
    "topicId": null,
    "assignee": null,
    "publicStatus": "received",
    "createdAt": "2026-11-12T10:41:31.000Z",
    "dashboardUrl": "https://…/?tab=all&id=8f3c…"
  }
}
ChampValeurs
intentfeedback, support
typebug, idea, pain, praise, question, off_topic
sentimentpositive, neutral, negative
identityverified, unverified, anonymous
publicStatusreceived, planned, in_progress, done, declined
assigneenull, ou { id, email, name } du membre attribué

Ni l'audio ni la capture ne sont envoyés : ouvrez dashboardUrl pour les voir.

Vérifier la signature

Calculez le HMAC-SHA256 du corps tel que reçu (avant tout parsing JSON) avec votre secret, et comparez en temps constant.

Node.js

JavaScript
import { createHmac, timingSafeEqual } from 'crypto'

function isFromParlo(rawBody, signatureHeader) {
  const expected = 'sha256=' + createHmac('sha256', process.env.PARLO_WEBHOOK_SECRET).update(rawBody).digest('hex')
  const received = signatureHeader || ''
  return received.length === expected.length && timingSafeEqual(Buffer.from(received), Buffer.from(expected))
}

PHP

PHP
$raw = file_get_contents('php://input');
$expected = 'sha256=' . hash_hmac('sha256', $raw, getenv('PARLO_WEBHOOK_SECRET'));
$ok = hash_equals($expected, $_SERVER['HTTP_X_PARLO_SIGNATURE'] ?? '');

Python

Python
import hashlib, hmac, os

def is_from_parlo(raw_body: bytes, signature: str) -> bool:
    expected = 'sha256=' + hmac.new(
        os.environ['PARLO_WEBHOOK_SECRET'].encode(), raw_body, hashlib.sha256
    ).hexdigest()
    return hmac.compare_digest(expected, signature or '')

Délais et nouvelles tentatives

Répondez par un code 2xx en moins de 8 secondes. Il n'y a pas encore de nouvelle tentative automatique : un envoi en échec reste visible dans le journal. Les retours de la page de test ont isTest: true.