https://retellai.com/?utm_source=discord&utm_medium=seo logo
Probleme de'utilisation du webhook
# ❓・ai-evy-support
t
@AI Evy Probleme de'utilisation du webhook
a
Thanks for tagging me @ts8466. I'll look through relevant sources and get back to you shortly.
### Answer Je comprends que vous rencontrez des problèmes avec les webhooks. Voici quelques points clés à vérifier : ## Points de vérification courants 1. Spécifications du webhook - Le webhook envoie une requête
POST
à 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
Copy code
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.)
​ To learn more, see the sources I considered: [[1] Webhook Overview](https://docs.retellai.com/features/webhook-overview) [[2] Secure the webhook](https://docs.retellai.com/features/secure-webhook) ​
Feel free to tag @AI Evy with additional questions. I also appreciate feedback, it helps me improve.
t
@AI Evy je voudrais savoir : Quand je recois un appel l'agent doit identifier le numero de telephone de l'appelant et l'envoyer vers le webhook pour recevoir toutes les informations sur ce client en fonction de son numero de telephone puis l'agent doit utiliser ces donnees pendant l'appel pour adapter ses questions (par exemple il sait si le client qui appelle est sous garantie ou non et repond en fonction). Il doit aussi utiliser les donnees qu'il a recu pour remplir le post call analysis. Ma question est comment placer cette appel de fonction : Jusqu'a aujourd'hui je l'ai placé directement sur le numero de telephone associé aux inbound call : Add an inbound webhook. avec l'adresse suivante https://aXXXXXe.app.n8n.cloud/webhook/call-started Mais je remarque que bien qu'il recoit les infos il ne les utilise pas pendant l'appel. Peut-etre est-ce parce que je ne mets pas l'appel du webhook au bon endroit. Par exemple au lieu de le mettre sur le numero de telephone au call-started je devrais creer une fonction dans l'agent et lui dire dans le prompt d'appeler ce webhook au debut de l'appel (mais dans ce cas la est ce qu'il saura lui envoyé le numero de tel de l'appelant qu'il recoit dans call-started?) sinon il reste MCP mais cela sera-t-il plus efficace ? Peux tu me dire quelle est la bonne méthode.
a
Thanks for the follow-up, @ts8466. I'll get back to you soon.
### Answer La méthode correcte est bien d'utiliser l'**inbound webhook** sur le numéro de téléphone, mais vous devez retourner les données client comme dynamic variables dans la réponse du webhook pour que l'agent puisse les utiliser pendant l'appel. [(1) ]() ## Le problème actuel Votre webhook reçoit l'appel mais ne renvoie probablement pas les données dans le bon format. L'inbound webhook doit retourner les informations client via
dynamic_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 :
Copy code
json
{
  "call_inbound": {
    "dynamic_variables": {
      "customer_name": "John Doe",
      "sous_garantie": "oui",
      "date_achat": "2024-01-15"
    },
    "metadata": {
      "customer_id": "12345"
    }
  }
}
, [(2) ]() ## Utilisation dans l'agent Une fois configuré, vous pouvez utiliser ces variables dans votre prompt avec la syntaxe
{{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) ]()
​ To learn more, see the sources I considered: [[1] Inbound webhook](https://docs.retellai.com/features/inbound-call-webhook) [[2] Discord message from @katecardenas_67927 on 2025-09-17](https://discord.com/channels/1186424376300679209/1186462578310910112/1417939440860528783) [[3] Post Call Analysis Overview](https://docs.retellai.com/features/post-call-analysis-overview) [[4] Discord message from @yves_69297 on 2025-01-16](https://discord.com/channels/1186424376300679209/1186462578310910112/1329371703100571778) ​
Feel free to tag @AI Evy with additional questions. I also appreciate feedback, it helps me improve.
t
@AI Evy dans les post call extraction il y a une case Description, cette case est pour moi pour me souvenir de ce que je veux ou c'est une case pour donner des regles a l'agent IA pour lui expliquer quelle donnee je veux ? Voir screenshot https://cdn.discordapp.com/attachments/1468975356651372736/1469261463633006602/Capture_decran_2026-02-06_a_11.18.11.png?ex=698703de&is=6985b25e&hm=ef9664992924750d02da2a6834b79261ddcb38df4acacba287e414847b6afa0f&
a
Thanks for the follow-up, @ts8466. I'll get back to you soon.
### Answer La case Description dans le post-call analysis sert à guider l'IA pour qu'elle comprenne quelle donnée extraire de la conversation. Ce n'est pas juste un mémo pour vous. [(1) ]() ## Comment ça fonctionne Quand vous configurez un champ de post-call analysis, la description explique au modèle LLM ce qu'il doit chercher dans la transcription de l'appel. [(2) ]() Exemple de configuration via l'API :
Copy code
json
"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) ]()
​ To learn more, see the sources I considered: [[1] Create Voice Agent](https://docs.retellai.com/api-references/create-agent) [[2] Post Call Analysis Overview](https://docs.retellai.com/features/post-call-analysis-overview) [[3] Discord message from @masanovets on 2024-11-23](https://discord.com/channels/1186424376300679209/1186462578310910112/1309859852725522502) [[4] Post Call Data Analysis - Nullable Variables](https://discord.com/channels/1186424376300679209/1376599913621885099) ​
Feel free to tag @AI Evy with additional questions. I also appreciate feedback, it helps me improve.