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ête | Valeur |
|---|---|
Content-Type | application/json |
X-Parlo-Event | feedback.analyzed ou test |
X-Parlo-Signature | sha256= suivi du HMAC-SHA256 du corps brut, en hexadécimal |
User-Agent | Parlo-Webhook/1 |
{
"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…"
}
}| Champ | Valeurs |
|---|---|
intent | feedback, support |
type | bug, idea, pain, praise, question, off_topic |
sentiment | positive, neutral, negative |
identity | verified, unverified, anonymous |
publicStatus | received, planned, in_progress, done, declined |
assignee | null, 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
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
$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
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.