> ## 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.
# Migrate CRM card views
> Troca um cartão de CRM antigo por um cartão de aplicativo nas exibições. Consulte a documentação "Migrar um cartão de CRM antigo para um cartão de aplicativo" para obter mais informações
export const SupportedProducts = ({marketing, sales, service, cms, marketingLevel, salesLevel, serviceLevel, cmsLevel}) => {
const translations = {
header: "Produtos suportados",
description: "Requer um dos seguintes produtos ou superior.",
productNames: {
marketing: "Marketing Hub",
sales: "Sales Hub",
service: "Service Hub",
cms: "Content Hub"
},
tiers: {
free: "Grátis",
starter: "Starter",
professional: "Professional",
enterprise: "Enterprise"
}
};
const translateTier = tier => {
if (!tier) return '';
const lowerTier = tier.toLowerCase();
return translations.tiers[lowerTier] || tier;
};
const products = [{
name: marketing ? translations.productNames.marketing : '',
level: translateTier(marketingLevel),
icon: "https://mintlify-assets.b-cdn.net/Icons/marketing-bolt.svg",
alt: "Marketing Hub"
}, {
name: sales ? translations.productNames.sales : '',
level: translateTier(salesLevel),
icon: "https://mintlify-assets.b-cdn.net/Icons/sales-star.svg",
alt: "Sales Hub"
}, {
name: service ? translations.productNames.service : '',
level: translateTier(serviceLevel),
icon: "https://mintlify-assets.b-cdn.net/Icons/service-heart.svg",
alt: "Service Hub"
}, {
name: cms ? translations.productNames.cms : '',
level: translateTier(cmsLevel),
icon: "https://mintlify-assets.b-cdn.net/Icons/content-play.svg",
alt: "Content Hub"
}].filter(product => product.name && product.level);
if (products.length === 0) return null;
return
{translations.description}
{products.map((product, index) =>
{product.name} -{product.level}
)}
;
};
## OpenAPI
````yaml specs/legacy/v3/crm-public-app-crm-cards-v3.json POST /crm/v3/extensions/cards-dev/{appId}/views/migrate
openapi: 3.0.1
info:
title: Cartões de CRM do aplicativo público
description: >-
Allows an app to extend the CRM UI by surfacing custom cards in the sidebar
of record pages. These cards are defined up-front as part of app
configuration, then populated by external data fetch requests when the
record page is accessed by a user.
version: v3
x-hubspot-product-tier-requirements:
marketing: FREE
sales: FREE
service: FREE
cms: FREE
commerce: FREE
crmHub: FREE
dataHub: FREE
x-hubspot-api-use-case: >-
Adicione um cartão personalizado aos registros de contato para exibir dados
do seu software externo de rastreamento de bugs.
x-hubspot-related-documentation:
- name: Custom Cards Guide
url: https://developers.hubspot.com/docs/guides/api/crm/extensions/crm-cards
x-hubspot-introduction: >-
Crie cartões personalizados para dados de sistemas externos em registros do
CRM. Requer um aplicativo público. Esses cartões do CRM são diferentes das
extensões de UI que você pode criar com projetos.
servers:
- url: https://api.hubapi.com
security: []
tags:
- name: Advanced
- name: Basic
paths:
/crm/v3/extensions/cards-dev/{appId}/views/migrate:
post:
tags:
- Advanced
summary: Migrar cartão nas exibições
description: >-
Troca um cartão de CRM antigo por um cartão de aplicativo nas exibições.
Consulte a documentação "Migrar um cartão de CRM antigo para um cartão
de aplicativo" para obter mais informações
operationId: >-
post-/crm/v3/extensions/cards-dev/{appId}/views/migrate_/crm/v3/extensions/cards-dev/{appId}/views/migrate
parameters:
- name: appId
in: path
description: O ID do aplicativo que contém o Cartão de CRM antigo
required: true
style: simple
explode: false
schema:
type: integer
format: int32
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/CardMigrateViewsRequest'
required: true
responses:
'200':
description: successful operation
content:
application/json:
schema:
$ref: '#/components/schemas/CardMigrateViewsResponse'
default:
$ref: '#/components/responses/Error'
description: ''
security:
- oauth2:
- developers-write
components:
schemas:
CardMigrateViewsRequest:
required:
- allowDuplicateAppCardIds
- appCardId
- legacyCrmCardId
type: object
properties:
allowDuplicateAppCardIds:
type: boolean
description: >-
O padrão é falso. Isso permite que mais de uma migração de cartão de
CRM antigo aponte para o mesmo cartão de extensão. Isso é evitado
por padrão para evitar a consolidação acidental de cartões.
appCardId:
type: integer
description: >-
O ID do cartão de aplicativo pelo qual substituir o cartão de CRM
antigo nas exibições
format: int64
helpdeskAppCardId:
type: integer
description: >-
O ID do cartão do aplicativo de Help desk para substituir o cartão
de CRM antigo nas exibições do Help desk. Necessário apenas se o
cartão de CRM antigo oferecia suporte a tickets, pois, nesse caso,
ele estaria disponível nas exibições do Help desk.
format: int64
legacyCrmCardId:
type: integer
description: O ID do cartão CRM antigo a ser trocado
format: int64
CardMigrateViewsResponse:
required:
- message
type: object
properties:
endedAt:
type: integer
description: A data/hora em que a migração terminou.
format: int64
message:
type: string
description: >-
Uma mensagem legível por humanos que descreve o erro, juntamente com
as etapas de correção, quando apropriado
remainingPortalCount:
type: integer
description: >-
O número de portais que ainda precisam ser trocados do cartão de CRM
antigo para o cartão de aplicativo
format: int64
startedAt:
type: integer
description: A data e a hora em que a migração começou.
format: int64
totalPortalCount:
type: integer
description: O número total de portais que têm acesso ao cartão de CRM antigo
format: int64
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
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
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
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:
developers-read: ''
developers-write: ''
private-apps-read: ''
````
{product.name} -
{product.level}
)}