API de registro de actividad de CRM
Comenzando
Para ayudar a los concesionarios a mejorar la gestión de sus oportunidades de venta y proporcionar a BRP información del mercado y conocimientos sobre la demanda, su CRM envía un registro diario de actividad.
El registro de actividad del CRM proporciona información sobre cómo el concesionario gestiona las oportunidades de venta enviadas por BRP (oportunidades de nivel 1) y sobre las oportunidades creadas directamente dentro de su CRM (oportunidades de nivel 3).
El objetivo de BRP es obtener una visión general de la gestión de oportunidades de venta por parte de los concesionarios, por ejemplo:
- ¿Cuántas oportunidades crea el concesionario en su CRM?
- ¿Cuántas resultaron en una venta de una unidad?
- ¿Cuáles son las acciones más comunes realizadas?
Tener esta visibilidad ayudará a BRP a mejorar las promociones y crear programas para mejorar la gestión de oportunidades de venta por parte de los concesionarios.
❗❗ Si no hay cambios en las oportunidades de venta realizados durante el día, no envíe un payload vacío, no llame a la API ❗❗
❗El registro de actividad del CRM se envía solo si el concesionario consiente compartir los datos.
¿Dónde empezar? ¡Léeme primero!
Antes de comenzar a trabajar en esta API, debes leer las siguientes secciones si aún no las has revisado:
Información técnica
Características
Tipo de API | Tipo DSP | Versión DCP | Complejidad |
|---|---|---|---|
Obtener datos de BRP | DMS | V3 - Internacional | Bajo |
Enviar datos a BRP | CRM | V4 - Norteamérica | Un poco más |
Transacción con BRP | | | Algo más |
Autenticación
La API está usando Autenticación de Aplicaciones.
Necesitas un token de acceso válido antes de llamar a esta API, o tienes que llamar a la API de Autenticación de Aplicaciones para obtener uno.
¡El token de acceso es válido por 30 minutos! (1799 segundos)
URL base
Prueba | https://qa-cloud-api.brp.com/dcp/<v3 o v4> |
|---|---|
Producción | https://cloud-api.brp.com/dcp/<v3 o v4> |
Recurso: Actividad CRM
El Actividad CRM recurso permite que un CRM envíe oportunidades de ventas actualizadas por el concesionario, junto con la lista de acciones para cada una.
Representación 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"
}
]
}
]
}
Propiedades
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 oportunidad de ventas. | 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. | |
Limitaciones y restricciones
Tamaño de la Carga Útil
La API del Registro de Actividades del CRM se ejecuta en APIGee, que tiene un tamaño máximo de carga útil de 10 MB.
Consulte la sección 413 Entidad de Solicitud Demasiado Grande para obtener más información sobre cómo manejar el código de estado 413.
Comprender el Registro de Actividades del CRM
Esta sección proporciona información sobre varios aspectos del registro de actividades del CRM para ayudarle a implementar la interfaz.
Terminología de BRP
Antes de comenzar, definamos algunos términos.
- Lead de ventas: Un cliente potencial interesado en un producto BRP. Se dispone de cierta información sobre este cliente potencial, incluida su nombre, número de teléfono o dirección de correo electrónico, así como el producto que le interesa.
- Oportunidad de venta: Un cliente potencial validado y calificado ha sido asignado a un distribuidor.
- Disposición: Es el resultado de la oportunidad de venta procesada por el distribuidor. La oportunidad de venta puede resultar en contactar al cliente, una venta de una unidad o abandono.
- Nivel 1: Un cliente potencial que fue enviado a su CRM como una oportunidad de venta. Un cliente creó el cliente potencial a través de una de las plataformas de comunicación de BRP.
- Nivel 3: Un cliente potencial creado en su CRM por el distribuidor tras una llamada del cliente, visita a la concesionaria o a través del sitio web del distribuidor.
El ID y el Hash del Cliente
El objetivo del hash y el ID del cliente es identificar a los clientes sin compartir su información personal, y recopilar información sobre clientes recurrentes y sus solicitudes.
Las reglas y leyes de privacidad de datos han estado vigentes en algunos países durante años y ahora se están implementando en muchos otros.
Por esta razón, la carga útil del registro de actividad del CRM no contiene la información personal del cliente.
Puede ver que la carga útil incluye la propiedad customer_id, que es el identificador de la cuenta del cliente en el CRM.
Es un elemento que puede ayudar a identificar a un cliente, pero es posible que el distribuidor no haya creado una cuenta para el cliente, y que un cliente pueda acudir a diferentes concesionarios y tener múltiples customer_id.
La customer_hashpropiedad en el objeto customer ha sido diseñada para no ser reversible: no se pueden recuperar el correo electrónico ni el número de teléfono del cliente a partir del hash.
Es esencial incluir el valor hash ÚNICAMENTE si tanto el correo electrónico como el número de teléfono del cliente están disponibles.
Si falta uno de ellos, el valor hash debe establecerse en null.
El hash se calcula utilizando un hash SHA-256 del número de teléfono, codificado según el estándar E.164, un espacio y la dirección de correo electrónico, todo en minúsculas.
Actividades Diarias vs Registro Histórico
El registro de actividades del CRM contiene dos tipos de información para cada oportunidad de venta: detalles de actividad e historial de actividad.
- La propiedad del estado de la oportunidad de venta (items.status), que coincide con el estado enviado a BRP a través de la API de oportunidad de ventas.
- La lista de acciones realizadas por el concesionario sobre la oportunidad de venta (items.actions).
❗ Todas las demás propiedades siempre se envían ❗
Cada uno de estos elementos es una lista que contiene todos los estados de las oportunidades de venta y todas las acciones realizadas desde su creación.
La información se puede enviar de dos maneras:
- Si tu CRM almacena todo el historial de oportunidades de venta y puede acceder a él fácilmente, la información enviada para cada oportunidad de venta puede incluir todos los cambios de estado y acciones.
- Si tu CRM no tiene el historial de oportunidades de venta, puede enviar los cambios de estado y las acciones realizadas desde la última carga del registro de actividad del CRM.
❗ Si una oportunidad de venta no fue modificada, no la envíes ❗
En el primer caso, la carga útil del registro de actividad de tu CRM contiene todos los datos de las oportunidades de venta modificadas.
Se muestra un ejemplo en el payload a continuación. La status y la lista de actions contiene muchas entradas ya que se envió el historial.
{
"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"
}
]
}
]
} Si tu CRM está enviando solo los cambios desde la carga de la lista, el payload para el mismo lead se ve como el mostrado a continuación. Solo se envían el último estado y la última acción.
{
"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"
}
]
}
]
} Es posible enviar un registro de actividad solo con la acción realizada si el estado no fue cambiado.
{
"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 estado de la oportunidad de venta
Una oportunidad de venta puede tener uno de los cuatro valores de estado siguientes. Su CRM puede tener valores de estado más detallados, y la tabla debería ayudarle a mapear su estado interno con un estado de oportunidad de venta.
👉 Los mismos estados se utilizan en el endpoint de actualización de API de oportunidad de ventas .
Estado de Oportunidad de Venta | Significado |
|---|---|
nuevo | La oportunidad de venta ha sido creada en tu CRM. |
contactado | El cliente ha sido contactado por algún medio (SMS, llamada telefónica, correo electrónico, etc.). 👉 Mientras se mantenga la comunicación con el cliente, el estado permanece como contactado. |
unit_sold | La oportunidad de venta ha resultado en la venta de un vehículo. |
abandonado | La oportunidad de venta se ha cerrado sin la venta de un vehículo. |
Propiedades mapeadas vs sin procesar
Verá en la carga útil que tres de las propiedades tienen dos formatos:
- Un formato BRP.
- El formato de tu CRM.
Las tres propiedades en el formato de BRP son:
- La propiedad source: de dónde se origina el lead.
- La propiedad status.code: el estado del lead de venta.
- La propiedad action.code: la acción tomada por el concesionario.
Para estas tres propiedades, tu CRM debe asignar sus valores internos a uno de los valores válidos para cada propiedad.
Para cada una de las propiedades, existe otra que se envía con el valor interno de tu CRM:
- crm_source
- status.crm_code
- actions.crm_code
El objetivo de los dos formatos es que BRP analice rápidamente los datos, utilizando valores estandarizados para cada propiedad.
Sin embargo, en algunos casos, más de un valor en tu CRM puede asignarse al mismo valor de BRP.
Por ejemplo, el estado abandonado podría representar muchos estados diferentes de oportunidades de venta, como cerrado, cancelado, no show, etc.
Valor faltante para una propiedad
Si tu CRM no tiene la información para una propiedad, puedes establecer la propiedad según el tipo de propiedad:
- String: una cadena vacía ("") o null.
- Número: un valor nulo.
- Fecha: un valor nulo.
Cuándo enviar
Su CRM debe enviar el registro de actividad del CRM diariamente, por ejemplo, al final del día laboral del concesionario o a una hora fija.
❗El registro de actividad del CRM se envía solo si el concesionario consiente compartir datos.
❗ Si no hay cambios en un lead de ventas, no lo envíe ❗
❗❗ Si no hay cambios en los leads de ventas realizados durante el día, no envíe un payload vacío, no llame a la API ❗❗
Referencia de 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"
}
]
}
]
}'Cómo hacerlo
Esta sección proporciona información sobre cómo obtener resultados específicos con la API.
Enviar registro de actividad del CRM
En este ejemplo, su CRM envía un registro de actividad para dos oportunidades de venta, una de BRP y otra creada en su CRM por el concesionario.
❗El registro de actividad del CRM se envía solo si el concesionario acepta compartir los datos.
❗ Si no hay cambios en un cliente potencial de ventas, no lo envíe ❗
❗❗ Si no hay cambios en los clientes potenciales de ventas realizados durante el día, no envíe una carga útil vacía, no llame a la API ❗❗
👉 En este ejemplo, se envía el historial completo del registro de actividad.
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"
}
]
}
]
}
'Manejo de errores
Esta sección presenta varios escenarios de llamadas incorrectas que resultan en mensajes de error y resultados inexactos.
400 Solicitud Incorrecta
El código de estado 400 se encuentra típicamente durante el desarrollo y la integración, y no debería aparecer en operaciones normales. La respuesta devuelta contiene la información necesaria para corregir el problema.
Muchos problemas pueden causar un código de estado 400; los más comunes se encuentran en la tabla siguiente.
Respuesta | Resolución |
|---|---|
Indicar que falta un campo obligatorio. {
"status": "400",
"id": "7acecbc0-7970-4505-86a7-fd6c48a5cc7c79012",
"title": "bad_request",
"meta": {
"service": "01",
"detail": "la validación de la solicitud falló",
"payload": {
"details": [
{
"message": "[Path '/items/0'] El objeto tiene propiedades obligatorias faltantes ([\"sales_opportunity_id\"]): []"
}
]
}
}
} | Asegúrate de enviar todos los campos del payload. |
El arreglo de estado está vacío. {
"status": "400",
"id": "f0bc7d7c-f043-42da-88d7-501a1c34938979852",
"title": "bad_request",
"meta": {
"service": "01",
"detail": "la validación de la solicitud falló",
"payload": {
"details": [
{
"message": "[Path '/items/0/status'] El arreglo es demasiado corto: debe tener al menos 1 elemento pero tiene 0: []"
}
]
}
}
} | El payload debe incluir al menos un estado para cada oportunidad de venta. |
El arreglo de acciones está vacío. {
"status": "400",
"id": "f0bc7d7c-f043-42da-88d7-501a1c34938979910",
"title": "bad_request",
"meta": {
"service": "01",
"detail": "la validación de la solicitud falló",
"payload": {
"details": [
{
"message": "[Path '/items/0/actions'] El arreglo es demasiado corto: debe tener al menos 1 elemento pero tiene 0: []"
}
]
}
}
} | El payload debe incluir al menos una acción para cada oportunidad de venta. |
401 No autorizado
El código de estado de error 401 No autorizado se devuelve cuando intentas llamar a la API con un access_token expirado.
Debes obtener un nuevo access_token con una llamada a la API de Autenticación de Aplicaciones.
El código de estado de error 401 No autorizado también se devuelve si no solicitaste acceso a la API creando un ticket en el Jira de DCP.
Cuando estés listo para comenzar a trabajar en una API, debes crear un ticket de certificación en Jira, como se describe en la sección Actividades de Certificación con Jira.
Si ya comenzaste a trabajar en una API y perdiste el acceso, crea un ticket de soporte como se describe en la sección Abrir un Ticket de Soporte.
413 Entidad de Solicitud Demasiado Grande
El código de estado 413 Request Entity Too Large se devuelve cuando la carga supera el límite de 10 MB de APIGee.
Tenga en cuenta que el código de estado 413 puede recibirse incluso si la carga que está enviando tiene menos de 10 MB. La carga se procesa y convierte antes de ser llamada por una API interna de BRP, y esta API interna puede devolver un código de estado 413.
Para corregir el problema, la única manera es dividir la carga en múltiples cargas. Debe definir el criterio que se utilizará para la división.
Requisitos DSP
Requisitos funcionales
ID | Tipo | Requisito |
|---|---|---|
1 | Obligatorio | El registro de actividades del CRM debe enviarse automáticamente diariamente, sin la intervención del concesionario. |
2 | Obligatorio | Su CRM debe llamar a la API de Información DSP para enviar una carga útil del registro de actividades del CRM para cada concesionario. |
3 | Obligatorio | Si no hay actividades del CRM para un concesionario, su CRM no debe enviar una carga útil del registro de actividades del CRM. |
Actividades de certificación
Esta sección describe todas las actividades de certificación y validaciones necesarias para certificar la API.
Garantía de calidad
Las pruebas enumeradas en la tabla a continuación deben completarse exitosamente en el entorno de prueba antes de que pueda comenzar la fase piloto del concesionario.
ID | Prueba | Resultado esperado |
|---|---|---|
1 | Enviar un registro de actividad CRM para una oportunidad de ventas BRP | La propiedad sales_opportunity_id debe contener el ID de BRP. |
2 | Enviar un registro de actividad CRM para un prospecto de ventas creado en su CRM. | La propiedad sales_opportunity_id debe estar vacía. |
3 | Enviar registros de actividad CRM para un prospecto de ventas creado en su CRM, incluidas las acciones realizadas sobre el prospecto y los cambios de estado. | El registro de actividad CRM debe mostrar todas las acciones ejecutadas y los cambios de estado. |
Piloto del distribuidor
La tabla a continuación describe los parámetros del piloto del distribuidor y sus validaciones correspondientes.
Parámetro | Valor |
|---|---|
Entorno | Producción |
Número de distribuidores | Todos sus distribuidores |
Duración | 2 semanas |
Validación 1 | El equipo DCP verifica que su CRM envía el registro de actividad diariamente. |
Validación 2 | Para uno o dos distribuidores, proporcione una muestra de 5 clientes potenciales de ventas enviados por BRP, junto con las acciones realizadas y los cambios de estado. La información debe proporcionarse en un formato legible para humanos.
La información se compara con el registro de actividad del CRM enviado. |
Validación 3 | Para uno o dos distribuidores, proporcione una muestra de 5 clientes potenciales de ventas creados en su CRM (excluyendo los enviados por BRP), junto con las acciones realizadas y los cambios de estado. La información debe proporcionarse en un formato legible para humanos. La información se compara con el registro de actividad del CRM enviado. |
Validación 4 | Verifique que el customer_id y el customer_hash se proporcionen para la mayoría de los registros de actividad del CRM, y que la información enviada parezca válida. |
Cartero
Esta sección describe lo que está disponible en Postman para explorar la API.
Entornos
Un entorno de Postman está disponible para probar la API de Dealers. Este entorno de Postman contiene variables utilizadas por las consultas y está configurado para conectarse al entorno de prueba.
Colecciones
La colección CRM - CRM Activity Logs contiene ejemplos de llamadas API para enviar un registro de actividad CRM.