> ## Documentation Index > Fetch the complete documentation index at: https://developers.hubspot.fr/docs/llms.txt > Use this file to discover all available pages before exploring further. # Retrieve conversation recap data > Récupérer un récapitulatif d'une conversation en fonction du type et de l'ID d'objet spécifiés. Ce point de terminaison fournit une variété d'informations relatives à la conversation, y compris : un résumé, les actions à entreprendre, les questions posées, les statistiques d'appel, les participants et l'URL de l'enregistrement. > **Supported products** > **Required Scopes** ## OpenAPI ````yaml specs/2026-09/crm-notetaker-conversation-recap-v2026-09.json GET /notetaker/2026-09/conversation/recap/{objectTypeId}/{objectId} openapi: 3.0.1 info: title: CRM Notetaker Conversation Recap description: Basepom for all HubSpot Projects version: 2026-09 x-hubspot-product-tier-requirements: marketing: FREE sales: FREE service: FREE cms: FREE commerce: FREE crmHub: FREE dataHub: FREE servers: - url: https://api.hubapi.com security: [] tags: - name: Basic paths: /notetaker/2026-09/conversation/recap/{objectTypeId}/{objectId}: get: tags: - Basic summary: Récupérer les données de récapitulatif de conversation description: "Récupérer un récapitulatif d'une conversation en fonction du type et de l'ID d'objet spécifiés. Ce point de terminaison fournit une variété d'informations relatives à la conversation, y compris\_: un résumé, les actions à entreprendre, les questions posées, les statistiques d'appel, les participants et l'URL de l'enregistrement." operationId: get-/notetaker/2026-09/conversation/recap/{objectTypeId}/{objectId} parameters: - name: objectId in: path description: >- L'identifiant unique de l'objet pour lequel le récapitulatif de conversation est récupéré. Il s'agit d'un paramètre entier obligatoire. required: true style: simple explode: false schema: type: string - name: objectTypeId in: path description: >- Le type d'objet pour lequel le récapitulatif de conversations est récupéré. Il s'agit d'un paramètre de chaîne obligatoire. required: true style: simple explode: false schema: type: string responses: '200': description: successful operation content: application/json: schema: $ref: '#/components/schemas/ConversationRecapResponse' default: $ref: '#/components/responses/Error' description: '' security: - oauth2: - crm.objects.contacts.highly_sensitive.read.v2 - oauth2: - crm.schemas.contacts.read - oauth2: - crm.objects.contacts.sensitive.read.v2 - oauth2: - crm.objects.contacts.read components: schemas: ConversationRecapResponse: required: - actionItems - callStats - notes - participants - questionsAsked - recordingUrl type: object properties: actionItems: $ref: '#/components/schemas/ConversationRecapActionItemsResult' callStats: $ref: '#/components/schemas/ConversationRecapCallStatsResult' notes: $ref: '#/components/schemas/ConversationRecapNotesResult' participants: $ref: '#/components/schemas/ConversationRecapParticipantsResult' questionsAsked: $ref: '#/components/schemas/ConversationRecapQuestionsAskedResult' recordingUrl: $ref: '#/components/schemas/ConversationRecapRecordingUrlResult' summary: $ref: '#/components/schemas/ConversationRecapSummaryResult' ConversationRecapActionItemsResult: required: - items - status type: object properties: error: $ref: '#/components/schemas/StandardError' items: type: array description: "La liste des éléments d'action extraits de la conversation. Remplie lorsque le statut est SUCCEEDED\_; vide dans le cas contraire." items: $ref: '#/components/schemas/ActionItem' status: type: string description: >- État actuel de la génération des éléments d'action. SUCCEEDED — les éléments d'action sont disponibles. NOT_FOUND — aucun élément d'action n'a été généré pour cet engagement. IN_PROGRESS — la génération est en cours. FAILED — une erreur s'est produite lors de la récupération des éléments d'action. enum: - FAILED - IN_PROGRESS - NOT_FOUND - NOT_SUPPORTED - SUCCEEDED ConversationRecapCallStatsResult: required: - hasTranscript - status type: object properties: durationMs: type: integer description: La durée de la conversation enregistrée en millisecondes. format: int64 error: $ref: '#/components/schemas/StandardError' hasTranscript: type: boolean description: Indique si une transcription de conversations a été trouvée. ownerTalkTimePercentage: type: string description: >- Le pourcentage de temps de parole attribué au participant propriétaire. status: type: string description: "Le statut de la récupération des statistiques d'appel est\_: SUCCEEDED, NOT_FOUND ou FAILED." enum: - FAILED - IN_PROGRESS - NOT_FOUND - NOT_SUPPORTED - SUCCEEDED ConversationRecapNotesResult: required: - status type: object properties: error: $ref: '#/components/schemas/StandardError' status: type: string description: >- Le statut de la récupération des notes. Soit SUCCEEDED, NOT_FOUND, soit FAILED. enum: - FAILED - IN_PROGRESS - NOT_FOUND - NOT_SUPPORTED - SUCCEEDED value: type: string description: Chaîne contenant les notes du récapitulatif de la conversation. ConversationRecapParticipantsResult: required: - items - status type: object properties: error: $ref: '#/components/schemas/StandardError' items: type: array description: >- Un tableau d'objets d'informations sur les participant·e·s, chacun contenant des détails sur un participant à la conversation. items: $ref: '#/components/schemas/ParticipantInfo' status: type: string description: >- Le statut de la récupération des participants. Soit SUCCEEDED, soit FAILED. enum: - FAILED - IN_PROGRESS - NOT_FOUND - NOT_SUPPORTED - SUCCEEDED ConversationRecapQuestionsAskedResult: required: - questionsAndAnswers - status type: object properties: error: $ref: '#/components/schemas/StandardError' questionsAndAnswers: type: array description: 'Une liste de paires de questions-réponses. ' items: $ref: '#/components/schemas/QuestionAndAnswer' status: type: string description: >- Le statut de la récupération des questions et réponses. Soit FAILED, NOT_FOUND et SUCCEEDED. enum: - FAILED - IN_PROGRESS - NOT_FOUND - NOT_SUPPORTED - SUCCEEDED ConversationRecapRecordingUrlResult: required: - status type: object properties: error: $ref: '#/components/schemas/StandardError' status: type: string description: >- Le statut de la création d'une URL. Soit FAILED, NOT_FOUND, ou SUCCEEDED. enum: - FAILED - IN_PROGRESS - NOT_FOUND - NOT_SUPPORTED - SUCCEEDED value: type: string description: L'URL de l'enregistrement sous forme de chaîne de caractères. ConversationRecapSummaryResult: required: - status type: object properties: error: $ref: '#/components/schemas/StandardError' status: type: string description: >- État actuel de la génération de résumé. SUCCEEDED — le résumé est disponible. NOT_FOUND — aucun résumé n'a été généré pour cet engagement. FAILED — une erreur s'est produite lors de la récupération du résumé. enum: - FAILED - IN_PROGRESS - NOT_FOUND - NOT_SUPPORTED - SUCCEEDED value: type: string description: "Le texte de résumé généré par l'IA pour la conversation. Présent lorsque le statut est SUCCEEDED\_; absent autrement." Error: required: - category - correlationId - message type: object properties: category: type: string description: >- La catégorie d'erreur, représentée sous forme de chaine de caractères. context: type: object additionalProperties: type: array items: type: string description: >- Un objet fournissant un contexte sur la condition d'erreur, où chaque propriété est un tableau de chaînes de caractères. example: >- {invalidPropertyName=[propertyValue], missingScopes=[scope1, scope2]} correlationId: type: string description: >- Un identifiant unique pour la requête, utilisé à des fins de suivi et de support. Il s'agit d'une chaîne au format UUID. format: uuid example: aeb5f871-7f07-4993-9211-075dc63e7cbf errors: type: array description: >- Un tableau contenant des informations supplémentaires sur l'erreur, chaque élément étant un objet ErrorDetail. items: $ref: '#/components/schemas/ErrorDetail' links: type: object additionalProperties: type: string description: >- Une carte des noms de liens vers les URI associés contenant de la documentation sur l'erreur ou les étapes de correction recommandées. Chaque lien est représenté comme une chaîne de caractères. message: type: string description: >- Un message lisible par l'utilisateur décrivant l'erreur ainsi que les mesures correctives à prendre, le cas échéant. Il s'agit d'une chaîne de caractères. example: An error occurred subCategory: type: string description: >- Une catégorie spécifique fournissant des informations plus détaillées sur l'erreur. Il s'agit d'une chaîne de caractères. description: >- Représente une réponse d'erreur renvoyée par l'API lorsqu'une opération échoue. Ce composant est utilisé dans divers points de terminaison pour fournir des informations détaillées sur l'erreur rencontrée. example: message: Invalid input (details will vary based on the error) correlationId: aeb5f871-7f07-4993-9211-075dc63e7cbf category: VALIDATION_ERROR links: knowledge-base: https://www.hubspot.com/products/service/knowledge-base StandardError: required: - category - context - errors - links - message - status type: object properties: category: type: string description: Chaîne représentant la catégorie de l'erreur. context: type: object additionalProperties: type: array items: type: string description: >- Un objet contenant un contexte additionnel sur la condition d'erreur, où chaque clé correspond à un tableau de chaînes de caractères. errors: type: array description: >- Un tableau d'objets ErrorDetail fournissant des informations supplémentaires sur l'erreur. items: $ref: '#/components/schemas/ErrorDetail' id: type: string description: >- Une chaîne qui permet d'identifier l'instance d'erreur de manière unique. links: type: object additionalProperties: type: string description: >- Un objet associant des noms de liens à des URI associées qui contiennent de la documentation ou des étapes de correction recommandées liées à l'erreur. message: type: string description: Message lisible par l'être humain décrivant l'erreur. status: type: string description: Une chaîne représentant le statut de l'erreur. subCategory: type: object properties: {} description: >- Un objet fournissant des détails plus spécifiques sur la catégorie d'erreur. description: Ye olde error ActionItem: required: - id - title type: object properties: assignee: type: string description: >- Une chaîne indiquant la personne assignée à l'élément d'action. Cette propriété est facultative. assigneeObjectId: type: string description: >- L'identifiant de l'utilisateur ou du contact HubSpot attribué à cet élément d'action, s'il est trouvé. Cette propriété est facultative. id: type: string description: >- L'identifiant unique de l'élément d'action, représenté sous forme de chaîne de caractères. title: type: string description: >- Une chaîne représentant le titre ou la description principale de l'élément d'action. Cette propriété est requise. ParticipantInfo: required: - isHost - name type: object properties: email: type: string description: >- L’adresse e-mail du participant. Présente uniquement lorsque le participant est un contact HubSpot. isHost: type: boolean description: Indique si ce participant était l'hôte des conversations. name: type: string description: 'Le nom du participant. ' phoneNumber: type: string description: >- Le numéro de téléphone du participant. Présent uniquement lorsque le participant est un contact HubSpot. QuestionAndAnswer: required: - question type: object properties: answer: $ref: '#/components/schemas/SpeakerStatement' question: $ref: '#/components/schemas/SpeakerStatement' ErrorDetail: required: - message type: object properties: code: type: string description: >- Le code de statut associé au détail de l'erreur. Cela permet d'identifier le type d'erreur qui s'est produite. context: type: object additionalProperties: type: array items: type: string description: >- Un objet fournissant un contexte sur la condition d'erreur. Il contient des propriétés supplémentaires qui offrent plus de détails, tels que des portées manquantes ou d'autres informations pertinentes. example: '{missingScopes=[scope1, scope2]}' in: type: string description: >- Le nom du champ ou du paramètre dans lequel l'erreur a été trouvée. Il fournit un contexte sur l'emplacement de l'erreur. message: type: string description: >- Un message lisible par l'utilisateur décrivant l'erreur ainsi que les mesures correctives à prendre, le cas échéant. Ce champ est obligatoire. subCategory: type: string description: >- Une catégorie spécifique qui contient des détails plus précis sur l'erreur. Elle offre une classification supplémentaire de l'erreur. description: >- Représente des informations détaillées sur une erreur survenue dans l'API. Ce composant est utilisé pour fournir un contexte et des spécificités supplémentaires sur les erreurs, généralement dans le cadre d'une réponse d'erreur. SpeakerStatement: type: object properties: speakerName: type: string description: L'intervenant attribué à cette déclaration. text: type: string description: L'heure à laquelle cette déclaration a eu lieu. timestampSeconds: type: number description: >- L'heure à laquelle cette déclaration a été faite dans une conversation enregistrée. responses: Error: description: An error occurred. content: '*/*': schema: $ref: '#/components/schemas/Error' securitySchemes: oauth2: type: oauth2 flows: authorizationCode: authorizationUrl: https://app.hubspot.com/oauth/authorize tokenUrl: https://api.hubapi.com/oauth/v1/token scopes: crm.objects.contacts.highly_sensitive.read.v2: '' crm.objects.contacts.read: '' crm.objects.contacts.sensitive.read.v2: '' crm.schemas.contacts.read: '' ````