> ## Documentation Index > Fetch the complete documentation index at: https://br.developers.hubspot.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Transcribe inbound call > Este endpoint processa chamadas recebidas aceitando uma solicitação com detalhes sobre a chamada. Exige um payload JSON contendo informações como ID externo da chamada, status final e números de telefone envolvidos. Esta operação é útil para integrar dados de chamadas de terceiros à HubSpot, permitindo rastreamento e gerenciamento contínuos de chamadas recebidas. > **Supported products** > **Required Scopes** ## OpenAPI ````yaml specs/2026-09/crm-transcriptions-v2026-09.json POST /crm/extensions/calling/2026-09/inbound-call openapi: 3.0.1 info: title: Transcrições 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: Advanced - name: Basic paths: /crm/extensions/calling/2026-09/inbound-call: post: tags: - Advanced summary: Atender chamada recebida description: >- Este endpoint processa chamadas recebidas aceitando uma solicitação com detalhes sobre a chamada. Exige um payload JSON contendo informações como ID externo da chamada, status final e números de telefone envolvidos. Esta operação é útil para integrar dados de chamadas de terceiros à HubSpot, permitindo rastreamento e gerenciamento contínuos de chamadas recebidas. operationId: >- post-/crm/extensions/calling/2026-09/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: Data e hora em que a chamada começou, no formato ISO 8601. format: date-time createEngagement: type: boolean description: >- Booleano que indica se um engajamento deve ser criado para esta chamada. durationSeconds: type: integer description: >- A duração da chamada em segundos, representada como um número inteiro. format: int32 engagementProperties: type: object additionalProperties: type: string description: >- Um mapa de nomes de propriedades personalizadas para seus valores, usado para armazenar informações adicionais sobre o engajamento. externalCallId: type: string description: O identificador exclusivo da chamada fornecido pelo sistema externo. finalCallStatus: type: string description: >- O status final da chamada. Os valores válidos incluem 'QUEUED', 'RINGING', 'IN_PROGRESS', 'CANCELED', 'COMPLETED', 'BUSY', 'FAILED', 'NO_ANSWER', 'CONNECTING', 'CALLING_CRM_USER', 'MISSED', 'HOLD' e '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: >- Matriz de números inteiros que representa IDs de usuário dos potenciais destinatários da chamada. items: type: integer format: int32 toNumber: $ref: '#/components/schemas/FormattedPhoneNumber' userId: type: integer description: >- Identificador exclusivo do usuário associado à chamada. É um número inteiro. format: int32 CompletedThirdPartyCallResponse: required: - callerIdMatches type: object properties: callerIdMatches: type: array description: >- Matriz que contém informações sobre as correspondências de ID do chamador. Cada item na matriz pode ser um objeto ContactCallerId ou CompanyCallerId. items: oneOf: - $ref: '#/components/schemas/ContactCallerId' - $ref: '#/components/schemas/CompanyCallerId' FormattedPhoneNumber: required: - e164Number - phoneNumberType type: object properties: e164Number: type: string description: >- O número de telefone formatado no padrão E.164, que inclui o código do país e o número do assinante como uma string. extension: type: string description: >- String opcional que representa o número de ramal associado ao número de telefone. phoneNumberType: type: string description: >- O tipo de número de telefone, representado como uma string. Os valores válidos incluem "FIXED_LINE", "MOBILE", "FIXED_LINE_OR_MOBILE", "TOLL_FREE", "PREMIUM_RATE", "SHARED_COST", "VOIP", "PERSONAL_NUMBER", "PAGER", "UAN", "VOICEMAIL" e "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: >- String que indica o tipo de ID do autor da chamada, que é "CONTACT" por padrão. default: CONTACT enum: - CONTACT email: type: string description: O endereço de e-mail do contato, representado como uma string. firstName: type: string description: O primeiro nome do contato, representado como uma string. lastName: type: string description: O sobrenome do contato, representado como uma string. objectCoordinates: $ref: '#/components/schemas/ObjectCoordinates' x-hubspot-sub-type-impl: true CompanyCallerId: title: COMPANY required: - callerIdType - objectCoordinates type: object properties: callerIdType: type: string description: >- String que representa o tipo de identificador de chamadas. O único valor válido é "COMPANY". default: COMPANY enum: - COMPANY name: type: string description: >- Uma string que representa o nome associado ao identificador de chamadas da empresa. objectCoordinates: $ref: '#/components/schemas/ObjectCoordinates' x-hubspot-sub-type-impl: true Error: required: - category - correlationId - message type: object properties: category: type: string description: A categoria de erro context: type: object additionalProperties: type: array items: type: string description: Contexto sobre a condição do erro example: >- {invalidPropertyName=[propertyValue], missingScopes=[scope1, scope2]} correlationId: type: string description: >- Um identificador exclusivo para a solicitação. Inclua este valor em relatórios de erro ou tickets de suporte format: uuid example: aeb5f871-7f07-4993-9211-075dc63e7cbf errors: type: array description: mais informações sobre o erro items: $ref: '#/components/schemas/ErrorDetail' links: type: object additionalProperties: type: string description: >- Um mapa de nomes de links para URIs associados que contêm documentação sobre o erro ou as etapas de correção recomendadas message: type: string description: >- Uma mensagem legível por humanos que descreve o erro, juntamente com as etapas de correção, quando apropriado example: An error occurred subCategory: type: string description: >- Uma categoria específica que contém mais detalhes específicos sobre o erro description: >- Representa uma resposta de erro retornada pela API quando uma operação falha. Este componente é usado em vários endpoints para fornecer informações detalhadas sobre o erro encontrado. 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: >- Identificador exclusivo para o objeto. É um número inteiro formatado como int64. format: int64 objectTypeId: type: string description: Identificador do tipo de objeto. É uma string. portalId: type: integer description: Identificador exclusivo do portal da HubSpot. É um número inteiro. format: int32 ErrorDetail: required: - message type: object properties: code: type: string description: O código de status associado ao detalhe do erro context: type: object additionalProperties: type: array items: type: string description: Contexto sobre a condição do erro example: '{missingScopes=[scope1, scope2]}' in: type: string description: O nome do campo ou parâmetro no qual o erro foi encontrado. message: type: string description: >- Uma mensagem legível por humanos que descreve o erro, juntamente com as etapas de correção, quando apropriado subCategory: type: string description: >- Uma categoria específica que contém mais detalhes específicos sobre o erro description: >- Representa informações detalhadas sobre um erro ocorrido na API. Este componente é usado para fornecer contexto e detalhes adicionais sobre os erros, geralmente como parte de uma resposta de erro. 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: '' ````