> ## 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. # Transcribe inbound call > Ce point de terminaison traite les appels entrants en acceptant une requête contenant les détails de l'appel. Il nécessite une charge utile JSON incluant des informations telles que l'ID externe de l'appel, son statut final et les numéros de téléphone impliqués. Cette opération est utile pour intégrer des données d'appel tierces dans HubSpot, permettant un suivi et une gestion fluides des appels entrants. > **Supported products** > **Required Scopes** ## OpenAPI ````yaml specs/2026-03/crm-transcriptions-v2026-03.json POST /crm/extensions/calling/2026-03/inbound-call openapi: 3.0.1 info: title: Transcriptions description: Basepom for all HubSpot Projects version: 2026-03 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: Advanced - name: Basic paths: /crm/extensions/calling/2026-03/inbound-call: post: tags: - Advanced summary: Gérer un appel entrant description: >- Ce point de terminaison traite les appels entrants en acceptant une requête contenant les détails de l'appel. Il nécessite une charge utile JSON incluant des informations telles que l'ID externe de l'appel, son statut final et les numéros de téléphone impliqués. Cette opération est utile pour intégrer des données d'appel tierces dans HubSpot, permettant un suivi et une gestion fluides des appels entrants. operationId: >- post-/crm/extensions/calling/2026-03/inbound-call_/crm/v3/extensions/calling/inbound-call parameters: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/CompletedThirdPartyCallRequest' required: true responses: '200': description: successful operation content: application/json: schema: $ref: '#/components/schemas/CompletedThirdPartyCallResponse' default: $ref: '#/components/responses/Error' description: '' security: - oauth2: - crm.objects.contacts.highly_sensitive.write.v2 - oauth2: - crm.objects.contacts.write - oauth2: - crm.objects.contacts.sensitive.write.v2 - oauth2: - crm.schemas.contacts.write components: schemas: CompletedThirdPartyCallRequest: required: - createEngagement - engagementProperties - externalCallId - finalCallStatus - fromNumber - potentialRecipientUserIds - toNumber type: object properties: callStartedTimestamp: type: string description: La date et l'heure de début de l'appel, au format ISO 8601. format: date-time createEngagement: type: boolean description: Un booléen indiquant si un engagement doit être créé pour cet appel. durationSeconds: type: integer description: La durée de l'appel en secondes, représentée par un entier. format: int32 engagementProperties: type: object additionalProperties: type: string description: >- Une carte des noms de propriétés personnalisées et de leurs valeurs, utilisée pour stocker des informations supplémentaires sur l'engagement. externalCallId: type: string description: Un identifiant unique pour l'appel fourni par le système externe. finalCallStatus: type: string description: "Le statut final de l'appel. Les valeurs valides incluent «\_QUEUED\_», «\_RINGING\_», «\_IN_PROGRESS\_», «\_CANCELED\_», «\_COMPLETED\_», «\_BUSY\_», «\_FAILED\_», «\_NO_ANSWER\_», «\_CONNECTING\_», «\_CALLING_CRM_USER\_», «\_MISSED\_», «\_HOLD\_» et «\_UNKNOWN\_»." enum: - BUSY - CALLING_CRM_USER - CANCELED - COMPLETED - CONNECTING - FAILED - HOLD - IN_PROGRESS - MISSED - NO_ANSWER - QUEUED - RINGING - UNKNOWN fromNumber: $ref: '#/components/schemas/FormattedPhoneNumber' potentialRecipientUserIds: type: array description: >- Un tableau d'entiers représentant les identifiants d'utilisateur des destinataires potentiels de l'appel. items: type: integer format: int32 toNumber: $ref: '#/components/schemas/FormattedPhoneNumber' userId: type: integer description: >- L'identifiant unique de l'utilisateur associé à l'appel, représenté par un entier. format: int32 CompletedThirdPartyCallResponse: required: - callerIdMatches type: object properties: callerIdMatches: type: array description: >- Un tableau contenant des informations sur les correspondances d'identification de l'appelant. Chaque élément du tableau peut être un objet ContactCallerId ou CompanyCallerId. items: oneOf: - $ref: '#/components/schemas/ContactCallerId' - $ref: '#/components/schemas/CompanyCallerId' FormattedPhoneNumber: required: - e164Number - phoneNumberType type: object properties: e164Number: type: string description: >- Le numéro de téléphone formaté selon la norme E.164, qui inclut l'indicatif du pays et le numéro d'abonné sous forme de chaîne de caractères. extension: type: string description: >- Une chaîne facultative représentant le numéro de poste associé au numéro de téléphone. phoneNumberType: type: string description: "Le type de numéro de téléphone, représenté sous forme de chaîne de caractères. Les valeurs valides incluent «\_FIXED_LINE\_», «\_MOBILE\_», «\_FIXED_LINE_OR_MOBILE\_», «\_TOLL_FREE\_», «\_PREMIUM_RATE\_», «\_SHARED_COST\_», «\_VOIP\_», «\_PERSONAL_NUMBER\_», «\_PAGER\_», «\_UAN\_», «\_VOICEMAIL\_» et «\_UNKNOWN\_»." enum: - FIXED_LINE - FIXED_LINE_OR_MOBILE - MOBILE - PAGER - PERSONAL_NUMBER - PREMIUM_RATE - SHARED_COST - TOLL_FREE - UAN - UNKNOWN - VOICEMAIL - VOIP ContactCallerId: title: CONTACT required: - callerIdType - objectCoordinates type: object properties: callerIdType: type: string description: "Une chaîne indiquant le type d'identifiant d'appelant, qui est «\_CONTACT\_» par défaut." default: CONTACT enum: - CONTACT email: type: string description: >- L'adresse e-mail du contact, représentée sous forme de chaîne de caractères. firstName: type: string description: Le prénom du contact, représenté sous forme de chaîne de caractères. lastName: type: string description: >- Le nom de famille du contact, représenté sous forme de chaîne de caractères. objectCoordinates: $ref: '#/components/schemas/ObjectCoordinates' x-hubspot-sub-type-impl: true CompanyCallerId: title: COMPANY required: - callerIdType - objectCoordinates type: object properties: callerIdType: type: string description: "Une chaîne représentant le type d'identification de l'appelant. La seule valeur valide est «\_COMPANY\_»." default: COMPANY enum: - COMPANY name: type: string description: >- Une chaîne de caractères représentant le nom associé à l'identifiant de l'appelant de l'entreprise. objectCoordinates: $ref: '#/components/schemas/ObjectCoordinates' x-hubspot-sub-type-impl: true Error: required: - category - correlationId - message type: object properties: category: type: string description: La catégorie d'erreur context: type: object additionalProperties: type: array items: type: string description: Contexte concernant la condition d'erreur example: >- {invalidPropertyName=[propertyValue], missingScopes=[scope1, scope2]} correlationId: type: string description: >- Un identifiant unique pour la demande. Incluez cette valeur dans tous les rapports d'erreurs ou tickets d'assistance format: uuid example: aeb5f871-7f07-4993-9211-075dc63e7cbf errors: type: array description: informations supplémentaires à propos de l'erreur 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 mesures correctives recommandées message: type: string description: >- Un message lisible par la personne décrivant l'erreur ainsi que les mesures correctives possibles, le cas échéant example: An error occurred subCategory: type: string description: >- Une catégorie spécifique qui contient des détails plus précis sur l'erreur 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 ObjectCoordinates: required: - objectId - objectTypeId - portalId type: object properties: objectId: type: integer description: >- L'identifiant unique de l'objet. Il s'agit d'un entier formaté en int64. format: int64 objectTypeId: type: string description: L'identifiant du type d'objet. Il s'agit d'une chaîne de caractères. portalId: type: integer description: L'identifiant unique du portail HubSpot. Il s'agit d'un entier. format: int32 ErrorDetail: required: - message type: object properties: code: type: string description: Le code du statut associé au détail de l'erreur context: type: object additionalProperties: type: array items: type: string description: Contexte concernant la condition d'erreur example: '{missingScopes=[scope1, scope2]}' in: type: string description: Le nom du champ ou du paramètre dans lequel l'erreur a été trouvée. message: type: string description: >- Un message lisible par la personne décrivant l'erreur ainsi que les mesures correctives possibles, le cas échéant subCategory: type: string description: >- Une catégorie spécifique qui contient des détails plus précis sur 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. 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.extensions_calling_transcripts.read: '' crm.extensions_calling_transcripts.write: '' crm.objects.contacts.highly_sensitive.read.v2: '' crm.objects.contacts.highly_sensitive.write.v2: '' crm.objects.contacts.read: '' crm.objects.contacts.sensitive.read.v2: '' crm.objects.contacts.sensitive.write.v2: '' crm.objects.contacts.write: '' crm.schemas.contacts.read: '' crm.schemas.contacts.write: '' ````