La API de Ventas fue desarrollada para integrar leads a Zenvia Customer Cloud de manera asíncrona, permitiendo recibir un webhook con sus resultados.
Descubre en este artículo cómo activar la integración en tu cuenta y cómo configurar tu API.
⚠️ Atención: La integración de una API requiere conocimientos técnicos avanzados, por lo tanto, es importante contar con la ayuda de un desarrollador. Solo los usuarios con perfil de Operador o Administrador tienen acceso a esta funcionalidad.
Cómo activar la integración de la API de Ventas
Para activar la API de Ventas en Zenvia Customer Cloud, sigue estos pasos:
1. Accede a Ventas > Integraciones;
2. Haz clic en el ícono en la esquina inferior derecha;
3. Selecciona el elemento de API Access;
4. Configura los permisos necesarios, como tu asignación y los niveles de acceso;
5. Guarda el código de la API key.
¡Listo! Integración activada.
💡Tip: Solo puedes acceder a las rutas de la API si proporcionas la API key en las llamadas. Esta clave siempre se puede encontrar en tu lista de integraciones.
Conceptos de la API de Ventas
Algunos términos son exclusivos del módulo de Ventas en Zenvia Customer Cloud. Conoce más sobre cada uno:
Lead
Lead es la información básica de un contacto que ha ingresado a tu base de datos. Los leads pueden tener diferentes orígenes, ya sea de integraciones (Mercado Libre o PayPal) o de canales (WhatsApp o Instagram).
Cada contacto de Ventas se crea a partir de los datos de un lead. Cada lead está vinculado a un Prospect. Zenvia Customer Cloud es capaz de identificar y unir leads que comparten los mismos datos.
Ejemplo:
Lead 1: { phone: +55 51 987654321 }
Lead 2: { phone: +55 51 987654321, email: 'address@provider.com' }
En este ejemplo, Lead 2 tiene el mismo teléfono que Lead 1, por lo tanto, el software comprende que se trata del mismo contacto y agrupa esta información, convirtiendo a este Lead en Prospect.
El enlace a la documentación técnica está disponible en https://sales.zenvia.com/#tag/Leads
Prospect
Prospect es el nombre que reciben los contactos disponibles para interacciones en el módulo de Ventas en Zenvia Customer Cloud. Todo Prospect es un cliente potencial y tiene al menos un Lead como base.
El identificador de un prospect es una clave de 24 caracteres que contiene letras y números, esta identificación es diferente de la utilizada por la API de Contactos, donde el estándar es UUID: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
El enlace a la documentación técnica está disponible en https://sales.zenvia.com/#tag/Prospects
Agents
Agents es un perfil de usuario de Zenvia Customer Cloud que interactúa con los Prospects a través del módulo de Ventas. Consulta el artículo Agregar y gestionar usuarios de la organización para obtener más información sobre este tema.
El enlace a la documentación técnica está disponible en https://sales.zenvia.com/#tag/Agents
Groups
Groups son los grupos a los que pertenecen los usuarios de Zenvia Customer Cloud. Puedes tener más de un grupo y es posible realizar configuraciones de atención en tus grupos.
El enlace a la documentación técnica está disponible en https://sales.zenvia.com/#tag/Groups