API de Registro de Atividades de CRM
Introdução
Para ajudar os concessionários a melhorar a gestão de leads de vendas e fornecer à BRP informações de mercado e insights de demanda, o seu CRM envia um registro diário de atividades.
O registro de atividades do CRM fornece informações sobre como o concessionário gerencia os leads de vendas enviados pela BRP (leads de nível 1) e sobre os leads de vendas criados diretamente no seu CRM (leads de nível 3).
O objetivo da BRP é obter uma visão geral da gestão de leads de vendas pelos concessionários, por exemplo:
- Quantos leads o concessionário cria em seu CRM?
- Quantos resultaram em uma venda de unidade?
- Quais são as ações mais comuns realizadas?
Ter essa visibilidade ajudará a BRP a melhorar promoções e criar programas para aprimorar a gestão de leads de vendas dos concessionários.
❗❗ Se não houver alterações nos leads de vendas realizadas durante o dia, não envie um payload vazio, não chame a API ❗❗
❗O registro de atividades do CRM é enviado somente se o concessionário consentir com o compartilhamento de dados.
Onde Começar? Leia Isto Primeiro!
Antes de começar a trabalhar nesta API, você precisa ler as seguintes seções, caso ainda não as tenha visto:
Informações Técnicas
Características
Tipo de API | Tipo de DSP | Versão DCP | Complexidade |
|---|---|---|---|
Obter dados do BRP | DMS | V3 - Internacional | Baixa |
Enviar dados ao BRP | CRM | V4 - América do Norte | Um pouco mais |
Transação com BRP | | | Um pouco mais ainda |
Autenticação
A API está usando Autenticação de Aplicação.
Você precisa de um token de acesso válido antes de chamar esta API, ou você deve chamar a API de Autenticação de Aplicativos para obter um.
O token de acesso é válido por 30 minutos! (1799 segundos)
URL Base
Teste | https://qa-cloud-api.brp.com/dcp/<v3 ou v4> |
|---|---|
Produção | https://cloud-api.brp.com/dcp/<v3 ou v4> |
Recurso: Atividade CRM
O recurso Atividade CRM permite que um CRM envie oportunidades de vendas atualizadas pelo revendedor, junto com a lista de ações para cada uma.
Representação JSON
{
"items": [
{
"lead_id": "523452345346564",
"sales_opportunity_id": "00Q6s000001TQcaEAG",
"dealer_no": "0000691888",
"customer_id": "1234567",
"customer_hash": "b25d0a94ad6707d04957ca22400aeae92ba7a4497e53f25f1991d7323d0864e7",
"source": "brp",
"crm_source": "BRP",
"language": "en",
"product_interest": {
"category": "Watercraft",
"model": "Spark",
"brand": "seadoo_watercraft"
},
"status": [
{
"code": "new",
"set_on": "2020-06-12T14:48:12Z",
"crm_code": "created"
},
{
"code": "contacted",
"set_on": "2020-06-13T14:48:12Z",
"crm_code": "sent SMS"
}
],
"comments": "I am looking for a specific color for this sea doo. I would like it black and white",
"actions": [
{
"code": "received",
"set_on": "2020-06-13T14:48:12Z",
"user_name": "",
"crm_code": "created"
},
{
"code": "opened",
"set_on": "2020-06-13T14:59:12Z",
"user_name": "John Smith",
"crm_code": "processed"
},
{
"code": "status changed",
"set_on": "2020-06-13T15:48:12Z",
"user_name": "John Smith",
"crm_code": "updated"
}
]
}
]
}
Propriedades
Property | Type | Definition | Notes |
|---|---|---|---|
items | list of objects | List of activities performed by the dealers. There is one object per sales opportunity. |
|
items. lead_id | string | Internal lead ID from your CRM. |
|
items. sales_opportunity_id | string | Sales opportunity identifier from BRP. An empty string if the sales opportunity wasn’t sent by BRP (Tier-3). The sales opportunity identifier is sent by the API de Oportunidade de Vendas. | Max Length:18 |
items. dealer_no | string | Code that uniquely identifies a dealer. Must be 10 characters. If fewer than 10 characters, add '0' at the beginning. | Length: 10 |
items. customer_id | string | Unique identifier at the dealer (or CRM) level for this customer. NULL if there is no account for the customer in the CRM. | Max length: 50 characters |
Items. customer_hash | string | A SHA-256 hash on the customer's phone number and email. Required format is SHA-256(^\+[1-9]\d{1,14} \S+@\S+\.\S+$) i.e., SHA-256(E.164 phone number space email address). e.g.:SHA-256(+18882729222 [email protected]) If the email or phone number is missing, then use null. 👉 The email must be made all lowercase for the hash calculation. | Format: ^[a-fA-F0-9]{64}$ |
items. source | string | The source of the lead:
| Max Length:25
|
Item. crm_source | string | The CRM raw source information. | Max Length:50 |
items. language | string | Communication language of the customer, in ISO language code (ISO-639-1) | Format xx |
items. product_interest | object | The product the customer is interested in. | Max Length:50 |
items. product_interest. category | string | The category of the product in which the consumer is interested. | Max Length:100 |
items. product_interest. model | string | Model of the product in which the consumer is interested. | Max Length:50 |
items. product_interest. brand | string | The product brand that interests the consumer. One of:
| Max Length:100
|
items. status | list of objects | List of statuses attached to the sales opportunity. |
|
items. status. code | string | .Status code. One of :
| Max Length:15
|
items. status. crm_code | string | The CRM raw status code. | Max Length:50 |
items. status. set_on | datetime | Date and time at which the status has been set, in ISO 8601 format. | Format: YYYY-MM-DDTHH:MM:SSZ |
items. comments | string | Any comments left by the user, free text. | Max Length:4000 |
items. actions | list of objects | Actions taken by a user when they communicate with the lead. |
|
items. actions. code | string | Action code. One of:
| Max Length:25
|
items. actions. crm_code | string | The CRM raw action code. | Max Length:50 |
items. actions. set_on | string | Date and time at which the status has been set, in ISO 8601 format. | Format: YYYY-MM-DDTHH:MM:SSZ |
items. actions. username | string | User name from your CRM of the user who acted on the sales opportunity. Empty if no user is involved in the action. | |
Limitações e Restrições
Tamanho do Payload
A API do CRM Activity Log é executada no APIGee, que possui um tamanho máximo de payload de 10 MB.
Consulte a seção 413 Entidade da Requisição Muito Grande para obter mais informações sobre como lidar com o código de status 413.
Compreendendo o CRM Activity Log
Esta seção fornece informações sobre vários aspectos do CRM Activity Log para ajudá-lo a implementar a interface.
Terminologia da BRP
Antes de começarmos, vamos definir alguns termos.
- Lead de vendas: Um cliente em potencial interessado em um produto BRP. Algumas informações sobre esse cliente em potencial estão disponíveis, incluindo nome, número de telefone ou endereço de e-mail, bem como o produto de interesse.
- Oportunidade de venda: Um lead de vendas validado e qualificado foi atribuído a um concessionário.
- Disposição: É o resultado da oportunidade de venda processada pelo concessionário. A oportunidade de venda pode resultar em contato com o cliente, venda de uma unidade ou abandono.
- Nível 1: Um lead de vendas que foi enviado ao seu CRM como uma oportunidade de venda. Um cliente criou o lead de vendas através de uma das plataformas de comunicação da BRP.
- Nível 3: Um lead de vendas criado no seu CRM pelo concessionário após uma ligação do cliente, visita à concessionária ou através do site do concessionário.
O ID e o Hash do Cliente
O objetivo do hash e do ID do cliente é identificar clientes sem compartilhar suas informações pessoais e coletar informações sobre clientes recorrentes e seus pedidos.
Regras e leis de privacidade de dados existem há anos em alguns países e agora estão sendo implementadas em muitos outros.
É por isso que o payload do log de atividades do CRM não contém as informações pessoais do cliente.
Você pode ver que o payload inclui a propriedade customer_id, que é o identificador da conta do cliente no CRM.
É um elemento que pode ajudar a identificar um cliente, mas o concessionário pode não ter criado uma conta para o cliente, e um cliente pode ir a diferentes concessionárias e ter múltiplos customer_id.
A propriedade customer_hash no objeto customer foi projetada para ser irreversível: o e-mail e o número de telefone do cliente não podem ser recuperados a partir do hash.
É essencial incluir o valor do hash APENAS se tanto o e-mail quanto o número de telefone do cliente estiverem disponíveis.
Se um deles estiver ausente, o valor do hash deve ser definido como null.
O hash é calculado usando um hash SHA-256 do número de telefone, codificado de acordo com o padrão E.164, um espaço e o endereço de e-mail, tudo em letras minúsculas.
Atividades Diárias vs Registro Histórico
O registro de atividades do CRM contém dois tipos de informações para cada lead de vendas: detalhes da atividade e histórico da atividade.
- A propriedade de status do lead de vendas (items.status), que corresponde ao status enviado ao BRP através da API de Oportunidade de Vendas.
- A lista de ações realizadas pelo concessionário no lead de vendas (items.actions).
❗ Todas as outras propriedades são sempre enviadas ❗
Cada um desses itens é uma lista contendo todos os status dos leads de vendas e todas as ações realizadas desde que foram criados.
As informações podem ser enviadas de duas maneiras:
- Se o seu CRM armazena todo o histórico de leads de vendas e pode acessá-lo facilmente, as informações enviadas para cada lead de vendas podem incluir todas as mudanças de status e ações.
- Se o seu CRM não possui o histórico de leads de vendas, ele pode enviar as mudanças de status e ações realizadas desde o último envio do registro de atividades do CRM.
❗ Se um lead de vendas não foi modificado, não o envie ❗
No primeiro caso, o payload do registro de atividades do seu CRM contém todos os dados para os leads de vendas modificados.
Um exemplo é mostrado no payload abaixo. A status e a lista de ações contém muitas entradas já que o histórico foi enviado.
{
"items": [
{
"lead_id": "523452345346564",
"sales_opportunity_id": "00Q6s000001TQcaEAG",
"dealer_no": "0000691888",
"customer_id": "1234567",
"customer_hash": "b25d0a94ad6707d04957ca22400aeae92ba7a4497e53f25f1991d7323d0864e7",
"source": "brp",
"crm_source": "oem",
"language": "en",
"product_interest": {
"category": "Watercraft",
"model": "Spark",
"brand": "seadoo_watercraft"
},
"status": [
{
"code": "new",
"crm_code": "created",
"set_on": "2020-06-12T14:48:12Z"
},
{
"code": "contacted",
"crm_code": "active",
"set_on": "2020-06-13T14:48:12Z"
}
],
"comments": "I am looking for a specific color for this sea doo. I would like it black and white",
"actions": [
{
"code": "received",
"crm_code": "created",
"set_on": "2020-06-13T14:48:12Z",
"user_name": ""
},
{
"code": "opened",
"crm_code": "processed",
"set_on": "2020-06-13T14:59:12Z",
"user_name": "John Smith"
},
{
"code": "status changed",
"crm_code": "updated",
"set_on": "2020-06-13T15:48:12Z",
"user_name": "John Smith"
}
]
}
]
} Se o seu CRM estiver enviando apenas as mudanças desde o upload da lista, o payload para o mesmo lead se parece com o mostrado abaixo. Somente o último status e ação são enviados.
{
"items": [
{
"lead_id": "523452345346564",
"sales_opportunity_id": "00Q6s000001TQcaEAG",
"dealer_no": "0000691888",
"customer_id": "1234567",
"customer_hash": "b25d0a94ad6707d04957ca22400aeae92ba7a4497e53f25f1991d7323d0864e7",
"source": "brp",
"crm_source": "oem",
"language": "en",
"product_interest": {
"category": "Watercraft",
"model": "Spark",
"brand": "seadoo_watercraft"
},
"status": [
{
"code": "contacted",
"crm_code": "active",
"set_on": "2020-06-13T14:48:12Z"
}
],
"comments": "I am looking for a specific color for this sea doo. I would like it black and white",
"actions": [
{
"code": "status changed",
"crm_code": "updated",
"set_on": "2020-06-13T15:48:12Z",
"user_name": "John Smith"
}
]
}
]
} É possível enviar um registro de atividade apenas com a ação realizada caso o status não tenha sido alterado.
{
"items": [
{
"lead_id": "523452345346564",
"sales_opportunity_id": "00Q6s000001TQcaEAG",
"dealer_no": "0000691888",
"customer_id": "1234567",
"customer_hash": "b25d0a94ad6707d04957ca22400aeae92ba7a4497e53f25f1991d7323d0864e7",
"source": "brp",
"crm_source": "oem",
"language": "en",
"product_interest": {
"category": "Watercraft",
"model": "Spark",
"brand": "seadoo_watercraft"
},
"status": [],
"comments": "I am looking for a specific color for this sea doo. I would like it black and white",
"actions": [
{
"code": "SMS sent",
"crm_code": "texto sent",
"set_on": "2020-06-13T14:48:12Z",
"user_name": ""
}
]
}
]
} Código de Status da Oportunidade de Vendas
Uma oportunidade de vendas pode ter um dos quatro valores de status abaixo. Seu CRM pode ter valores de status mais detalhados, e a tabela deve ajudá-lo a mapear seu status interno para um status de oportunidade de vendas.
👉 Os mesmos status são usados no endpoint de atualização do API de Oportunidade de Vendas.
Status da Oportunidade de Venda | Significado |
|---|---|
new | A oportunidade de venda foi criada no seu CRM. |
contacted | O cliente foi contactado por algum meio (SMS, chamada telefônica, e-mail, etc.). 👉 Enquanto a comunicação for mantida com o cliente, o status permanece contacted. |
unit_sold | A oportunidade de venda resultou na venda de um veículo. |
abandoned | A oportunidade de venda foi encerrada sem a venda de um veículo. |
Propriedades Mapeadas vs Brutas
Você verá no payload que três das propriedades possuem dois formatos:
- Um formato BRP.
- O formato do seu CRM.
As três propriedades no formato da BRP são:
- A propriedade source: de onde a lead se origina.
- A propriedade status.code: o estado da lead de vendas.
- A propriedade action.code: a ação tomada pelo concessionário.
Para essas três propriedades, o seu CRM deve mapear seus valores internos para um dos valores válidos de cada propriedade.
Para cada uma das propriedades, há outra para enviar o valor interno do seu CRM:
- crm_source
- status.crm_code
- actions.crm_code
O objetivo dos dois formatos é permitir que a BRP analise rapidamente os dados, usando valores padronizados para cada propriedade.
No entanto, em alguns casos, mais de um valor no seu CRM pode ser mapeado para o mesmo valor BRP.
Por exemplo, o status abandonned pode representar muitos diferentes status de leads de vendas, como fechado, cancelado, não compareceu, etc.
Valor Ausente para uma Propriedade
Se o seu CRM não tiver a informação para uma propriedade, você pode definir a propriedade com base no tipo da propriedade:
- String: uma string vazia ("") ou null.
- Número: um valor nulo.
- Data: um valor nulo.
Quando Enviar
Seu CRM deve enviar o registro de atividades do CRM diariamente, por exemplo, no final do dia útil do concessionário ou em um horário fixo.
❗O registro de atividades do CRM só é enviado se o concessionário consentir com o compartilhamento de dados.
❗ Se não houver alterações em um lead de vendas, não o envie ❗
❗❗ Se não houver alterações nos leads de vendas feitas durante o dia, não envie um payload vazio, não chame a API ❗❗
Referência da API
curl --location 'https://cloud-api.brp.com/dcp/v3/dsp/0000690095/crm-activity' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--data '{
"items": [
{
"lead_id": "523452345346564",
"sales_opportunity_id": "00Q6s000001TQcaEAG",
"dealer_no": "0000691888",
"customer_id": "1234567",
"customer_hash": "b25d0a94ad6707d04957ca22400aeae92ba7a4497e53f25f1991d7323d0864e7",
"source": "brp",
"crm_source": "oem",
"language": "en",
"product_interest": {
"category": "Watercraft",
"model": "Spark",
"brand": "seadoo_watercraft"
},
"status": [
{
"code": "new",
"crm_code": "created",
"set_on": "2020-06-12T14:48:12Z"
},
{
"code": "contacted",
"crm_code": "active",
"set_on": "2020-06-13T14:48:12Z"
}
],
"comments": "I am looking for a specific color for this sea doo. I would like it black and white",
"actions": [
{
"code": "received",
"crm_code": "created",
"set_on": "2020-06-13T14:48:12Z",
"user_name": ""
},
{
"code": "opened",
"crm_code": "processed",
"set_on": "2020-06-13T14:59:12Z",
"user_name": "John Smith"
},
{
"code": "status changed",
"crm_code": "updated",
"set_on": "2020-06-13T15:48:12Z",
"user_name": "John Smith"
}
]
}
]
}'Como Fazer
Esta seção fornece informações sobre como obter resultados específicos com a API.
Enviar Registro de Atividade do CRM
Neste exemplo, seu CRM envia um registro de atividade para duas oportunidades de venda, uma da BRP e outra criada em seu CRM pelo concessionário.
❗O registro de atividade do CRM é enviado somente se o concessionário consentir com o compartilhamento de dados.
❗ Se não houver alterações em um lead de vendas, não o envie ❗
❗❗ Se não houver alterações nos leads de vendas feitas durante o dia, não envie um payload vazio, não chame a API ❗❗
👉 Neste exemplo, o histórico completo do registro de atividades é enviado.
curl --location 'https://qa-cloud-api.brp.com/dcp/v3/dsp/0000690095/crm-activity' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer VNFAyUxbLJcynBogyj5Q4o8wkdLg' \
--header 'Cookie: BrowserId=JpPoTqgdEe-njU30fg4qUA; CookieConsentPolicy=0:1; LSKey-c$CookieConsentPolicy=0:1' \
--data '{
"items": [
{
"lead_id": "523452345346564",
"sales_opportunity_id": "00Q6s000001TQcaEAG",
"dealer_no": "0000691888",
"customer_id": "1234567",
"customer_hash": "b25d0a94ad6707d04957ca22400aeae92ba7a4497e53f25f1991d7323d0864e7",
"source": "brp",
"crm_source": "oem",
"language": "en",
"product_interest": {
"category": "new",
"model": "Spark",
"brand": "seadoo_watercraft"
},
"status": [
{
"code": "new",
"crm_code": "created",
"set_on": "2020-06-12T14:48:12Z"
},
{
"code": "contacted",
"crm_code": "active",
"set_on": "2020-06-13T14:48:12Z"
}
],
"comments": "I am looking for a specific color for this sea doo. I would like it black and white",
"actions": [
{
"code": "received",
"crm_code": "created",
"set_on": "2020-06-13T14:48:12Z",
"user_name": ""
},
{
"code": "opened",
"crm_code": "processed",
"set_on": "2020-06-13T14:59:12Z",
"user_name": "John Smith"
},
{
"code": "status changed",
"crm_code": "updated",
"set_on": "2020-06-13T15:48:12Z",
"user_name": "John Smith"
}
]
},
{
"lead_id": "392487928374987",
"sales_opportunity_id": "",
"dealer_no": "0000691888",
"customer_id": "34345",
"customer_hash": "b25d0a94ad6707d044497e53f25f1991d7323d0864e7957ca22400aeae92ba7a",
"source": "walk_in",
"crm_source": "visit",
"language": "en",
"product_interest": {
"category": "new",
"model": "Mavrick",
"brand": "canam_offroad"
},
"status": [
{
"code": "new",
"crm_code": "created",
"set_on": "2020-06-12T14:48:12Z"
},
{
"code": "contacted",
"crm_code": "active",
"set_on": "2020-06-13T14:48:12Z"
},
{
"code": "unit_sold",
"crm_code": "sale",
"set_on": "2020-06-26T14:48:12Z"
}
],
"comments": "I have a Polaris unit for trade-in",
"actions": [
{
"code": "received",
"crm_code": "created",
"set_on": "2020-06-13T14:48:12Z",
"user_name": ""
},
{
"code": "opened",
"crm_code": "processed",
"set_on": "2020-06-13T14:59:12Z",
"user_name": "John Smith"
},
{
"code": "status changed",
"crm_code": "updated",
"set_on": "2020-06-13T15:48:12Z",
"user_name": "John Smith"
} ,
{
"code": "customer called",
"crm_code": "phone call",
"set_on": "2020-06-13T15:48:12Z",
"user_name": "John Smith"
}
]
}
]
}
'Tratamento de Erros
Esta seção apresenta vários cenários de chamadas incorretas que resultam em mensagens de erro e resultados imprecisos.
400 Requisição Inválida
O código de status 400 é normalmente encontrado durante o desenvolvimento e a integração e não deve aparecer em operações normais. A resposta retornada contém as informações necessárias para corrigir o problema.
Muitos problemas podem causar um código de status 400; os mais comuns estão na tabela abaixo.
Resposta | Resolução |
|---|---|
Indique que um campo obrigatório está faltando. {
"status": "400",
"id": "7acecbc0-7970-4505-86a7-fd6c48a5cc7c79012",
"title": "bad_request",
"meta": {
"service": "01",
"detail": "falha na validação da requisição",
"payload": {
"details": [
{
"message": "[Path '/items/0'] O objeto está faltando propriedades obrigatórias ([\"sales_opportunity_id\"]): []"
}
]
}
}
} | Certifique-se de que todos os campos do payload sejam enviados. |
O array de status está vazio. {
"status": "400",
"id": "f0bc7d7c-f043-42da-88d7-501a1c34938979852",
"title": "bad_request",
"meta": {
"service": "01",
"detail": "falha na validação da requisição",
"payload": {
"details": [
{
"message": "[Path '/items/0/status'] O array é muito curto: deve ter pelo menos 1 elemento, mas a instância tem 0 elementos: []"
}
]
}
}
} | O payload deve incluir pelo menos um status para cada lead de vendas. |
O array de ações está vazio. {
"status": "400",
"id": "f0bc7d7c-f043-42da-88d7-501a1c34938979910",
"title": "bad_request",
"meta": {
"service": "01",
"detail": "falha na validação da requisição",
"payload": {
"details": [
{
"message": "[Path '/items/0/actions'] O array é muito curto: deve ter pelo menos 1 elemento, mas a instância tem 0 elementos: []"
}
]
}
}
} | O payload deve incluir pelo menos uma ação para cada lead de vendas. |
401 Não Autorizado
O código de erro 401 Não Autorizado é retornado quando você tenta chamar a API com um access_token expirado.
Você precisa obter um novo access_token com uma chamada para a API de Autenticação de Aplicativos.
O código de erro 401 Não Autorizado também é retornado se você não solicitou acesso à API criando um ticket no DCP Jira.
Quando você estiver pronto para começar a trabalhar em uma API, deve criar um ticket de certificação no Jira, conforme descrito na seção Atividades de Certificação com Jira.
Se você já começou a trabalhar em uma API e perdeu o acesso, crie um ticket de suporte conforme descrito na seção Abrir um Ticket de Suporte.
413 Entidade da Requisição Muito Grande
O código de status 413 Request Entity Too Large é retornado quando o payload excede o limite de 10 MB do APIGee.
Observe que o código de status 413 pode ser recebido mesmo que o payload enviado tenha menos de 10 MB. O payload é processado e convertido antes de ser chamado por uma API interna do BRP, e essa API interna pode retornar um código de status 413.
Para corrigir o problema, a única forma é dividir o payload em vários payloads. Você deve definir o critério a ser usado para a divisão.
Requisitos DSP
Requisitos Funcionais
ID | Tipo | Requisito |
|---|---|---|
1 | Obrigatório | O registro de atividades do CRM deve ser automaticamente enviado diariamente, sem a intervenção do concessionário. |
2 | Obrigatório | Seu CRM deve chamar a API de Informações do DSP para enviar um payload de registro de atividades do CRM para cada concessionário. |
3 | Obrigatório | Se não houver atividades de CRM para um concessionário, seu CRM não deve enviar um payload de registro de atividades do CRM. |
Atividades de Certificação
Esta seção descreve todas as atividades e validações necessárias para certificar a API.
Garantia de Qualidade
Os testes listados na tabela abaixo devem ser concluídos com sucesso no ambiente de testes antes que você possa iniciar a fase piloto do revendedor.
ID | Teste | Resultado Esperado |
|---|---|---|
1 | Enviar um registro de atividade de CRM para uma Oportunidade de Vendas BRP | A propriedade sales_opportunity_id deve conter o ID BRP. |
2 | Enviar um registro de atividade de CRM para um lead de vendas criado no seu CRM. | A propriedade sales_opportunity_id deve estar vazia. |
3 | Enviar registros de atividade de CRM para um lead de vendas criado no seu CRM, incluindo ações realizadas no lead e alterações de status. | O registro de atividade do CRM deve exibir todas as ações executadas e alterações de estado. |
Piloto do Revendedor
A tabela abaixo descreve os parâmetros do piloto do revendedor e suas validações correspondentes.
Parâmetro | Valor |
|---|---|
Ambiente | Produção |
Número de concessionárias | Todas as suas concessionárias |
Duração | 2 semanas |
Validação 1 | A equipe DCP verifica que seu CRM envia o registro de atividades diariamente. |
Validação 2 | Para uma ou duas concessionárias, forneça uma amostra de 5 leads de vendas enviados pela BRP, juntamente com as ações realizadas e mudanças de status. As informações devem ser fornecidas em formato legível por humanos.
As informações são comparadas ao registro de atividades do CRM enviado. |
Validação 3 | Para uma ou duas concessionárias, forneça uma amostra de 5 leads de vendas criados no seu CRM (excluindo os enviados pela BRP), juntamente com as ações realizadas e mudanças de status. As informações devem ser fornecidas em formato legível por humanos. As informações são comparadas ao registro de atividades do CRM enviado. |
Validação 4 | Verifique se o customer_id e o customer_hash são fornecidos para a maioria dos registros de atividades do CRM e se as informações enviadas parecem válidas. |
Postman
Esta seção descreve o que está disponível no Postman para explorar a API.
Ambientes
Um ambiente Postman está disponível para testar a Dealers API. Este ambiente Postman contém variáveis usadas pelas consultas e está configurado para se conectar ao ambiente de teste.
Coleções
A coleção CRM - CRM Activity Logs contém exemplos de chamadas de API para enviar um registro de atividade de CRM.