ts8466
02/05/2026, 2:23 PMAI Evy
02/05/2026, 2:23 PMAI Evy
02/05/2026, 2:23 PMPOST à votre endpoint [(1) ]()
- Le délai d'expiration est de 10 secondes
- Si aucun code de succès (2xx) n'est reçu dans les 10 secondes, le webhook sera réessayé jusqu'à 3 fois
2. Vérification de la signature
- Utilisez l'en-tête x-retell-signature avec votre clé API Retell pour vérifier que le webhook provient bien de Retell AI [(2) ]()
- Seule la clé API avec un badge "webhook" peut être utilisée pour la vérification
- Vous pouvez également autoriser l'adresse IP Retell : 100.20.5.228
3. Réponse attendue
- Votre endpoint doit retourner un code de succès (2xx) [(1) ]()
- Aucun corps de réponse n'est attendu
## Exemple de code pour vérifier le webhook
javascript
import { Retell } from "retell-sdk";
import express, { Request, Response } from "express";
app.post("/webhook", (req: Request, res: Response) => {
if (
!Retell.verify(
JSON.stringify(req.body) ,
process.env.RETELL_API_KEY,
req.headers["x-retell-signature"] as string,
)
) {
console.error("Invalid signature") ;
return;
}
res.status(204) .send() ;
}) ;
[(2) ]()
Pourriez-vous préciser quel type de problème vous rencontrez exactement ? (erreurs de signature, timeouts, webhooks non reçus, etc.)AI Evy
02/05/2026, 2:24 PMAI Evy
02/05/2026, 2:24 PMts8466
02/05/2026, 2:41 PMAI Evy
02/05/2026, 2:41 PMAI Evy
02/05/2026, 2:41 PMdynamic_variables dans la réponse JSON.
## La bonne méthode
Votre webhook n8n doit :
1. Recevoir le from_number dans le payload (automatiquement envoyé par Retell)
2. Chercher les infos client dans votre CRM
3. Retourner une réponse JSON avec les données comme dynamic_variables
Format de réponse attendu :
json
{
"call_inbound": {
"dynamic_variables": {
"customer_name": "John Doe",
"sous_garantie": "oui",
"date_achat": "2024-01-15"
},
"metadata": {
"customer_id": "12345"
}
}
}AI Evy
02/05/2026, 2:41 PM{{customer_name}}, {{sous_garantie}}, etc.
[(1) ]()
## Pour le Post Call Analysis
Les données collectées via dynamic_variables peuvent ensuite être utilisées pour remplir les champs de post-call analysis. Vous pouvez définir des catégories personnalisées (Boolean, Text, Number, Selector) dans les paramètres de l'agent.
[(3) ]()
## Important
Si le numéro n'est pas trouvé dans votre CRM, vous devez quand même retourner une réponse 200 avec des valeurs par défaut, sinon l'appel ne sera pas connecté.
[(4) ]()AI Evy
02/05/2026, 2:41 PMAI Evy
02/05/2026, 2:41 PMts8466
02/06/2026, 9:20 AMAI Evy
02/06/2026, 9:20 AMAI Evy
02/06/2026, 9:20 AMjson
"post_call_analysis_data": [
{
"type": "string",
"name": "customer_name",
"description": "The name of the customer.",
"examples": [
"John Doe",
"Jane Smith"
]
}
]
[(1) ]()
## Bonnes pratiques
- Description : Soyez précis sur ce que vous voulez extraire (ex: "Le nom complet du client tel qu'il l'a donné pendant l'appel")
- Examples : Fournissez des exemples pour aider le LLM à comprendre le format attendu
, [(3) ]()
Le LLM essaiera de remplir ces variables, mais il n'y a pas de garantie qu'il trouvera toujours l'information si elle n'a pas été mentionnée dans la conversation.
[(4) ]()AI Evy
02/06/2026, 9:20 AMAI Evy
02/06/2026, 9:20 AM