> ## 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. # Submit details of an inbound call to the CRM. > Ce point de terminaison vous permet de soumettre des informations sur un appel entrant au système CRM. La requête doit inclure des détails tels que l'ID d'appel externe, le statut de l'appel et les numéros de téléphone impliqués. Cette opération facilite l'enregistrement et la gestion des données d'appels entrants au sein du CRM. > **Supported products** > **Required Scopes** ## OpenAPI ````yaml specs/legacy/v3/crm-calling-extensions-v3.json POST /crm/v3/extensions/calling/inbound-call openapi: 3.0.1 info: title: CRM Calling Extensions description: Basepom for all HubSpot Projects version: v3 x-hubspot-product-tier-requirements: marketing: FREE sales: FREE service: FREE cms: FREE commerce: FREE crmHub: FREE dataHub: FREE x-hubspot-related-documentation: - name: Call SDK Guide url: >- https://developers.hubspot.com/docs/guides/api/crm/extensions/calling-sdk servers: - url: https://api.hubapi.com security: [] tags: - name: Advanced - name: Basic - name: Batch paths: /crm/v3/extensions/calling/inbound-call: post: tags: - Advanced summary: Soumettre les détails d'un appel entrant au CRM. description: >- Ce point de terminaison vous permet de soumettre des informations sur un appel entrant au système CRM. La requête doit inclure des détails tels que l'ID d'appel externe, le statut de l'appel et les numéros de téléphone impliqués. Cette opération facilite l'enregistrement et la gestion des données d'appels entrants au sein du CRM. operationId: >- post-/crm/v3/extensions/calling/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: >- L'horodatage indiquant le début de l'appel, au format chaîne date-heure. format: date-time createEngagement: type: boolean description: Indique si un engagement doit être créé pour l'appel. durationSeconds: type: integer description: La durée de l'appel en secondes. format: int32 engagementProperties: type: object additionalProperties: type: string description: Contient des propriétés supplémentaires liées à l'engagement. externalCallId: type: string description: L'identifiant unique de l'appel provenant d'un système externe. finalCallStatus: type: string description: >- Le statut final de l'appel, avec les valeurs acceptées suivantes : BUSY, CALLING_CRM_USER, CANCELED, COMPLETED, CONNECTING, FAILED, HOLD, IN_PROGRESS, MISSED, NO_ANSWER, QUEUED, RINGING, 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 items: type: integer format: int32 toNumber: $ref: '#/components/schemas/FormattedPhoneNumber' userId: type: integer description: L'ID de l'utilisateur associé à l'appel. format: int32 CompletedThirdPartyCallResponse: required: - callerIdMatches type: object properties: callerIdMatches: type: array 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 au format standard E.164. extension: type: string description: 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, avec les valeurs acceptées incluant LIGNE_FIXE, MOBILE, VOIP, et autres. 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: >- Spécifie le type d'identification de l'appelant, la valeur par défaut étant CONTACT. default: CONTACT enum: - CONTACT email: type: string description: L'adresse e-mail du contact. firstName: type: string description: Le prénom du contact. lastName: type: string description: Le nom de famille du contact. objectCoordinates: $ref: '#/components/schemas/ObjectCoordinates' x-hubspot-sub-type-impl: true CompanyCallerId: title: COMPANY required: - callerIdType - objectCoordinates type: object properties: callerIdType: type: string description: >- Spécifie le type d'identification de l'appelant, défini sur « COMPANY » par défaut. default: COMPANY enum: - COMPANY name: type: string description: Le nom associé à l'ID d'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. format: int64 objectTypeId: type: string description: L'identifiant de type de l'objet. portalId: type: integer description: L'identifiant unique du portail. 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: automation: '' 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.objects.owners.read: '' crm.pipelines.approval.read: '' crm.pipelines.governance.write: '' crm.schemas.contacts.read: '' crm.schemas.contacts.write: '' ````