Requiere un acceso de usuario de la API con rutas de administración o personalizadas. |
Este artículo explicará cómo insertar leads en una campaña utilizando POST /leads punto final.
Si está buscando importaciones masívas, eche un vistazo a este artículo. Si busca la documentación de la API, siga este enlace.
Cuando es enviada una solicitud exitosa a este punto final, sucederán las dos cosas siguientes:
Se crea un contacto en un grupo.
El contacto está asociado a una campaña, lo que da lugar a la creación de un lead.
Para entender mejor la diferencia entre contactos y leads, consulte este artículo.
Los únicos parámetros requeridos para una simple solicitud de leads POST son la identificación de campaña, el grupo y los Datos maestros, una colección de identificaciones y valores de campos.
curl --location --request POST 'https://api.adversus.io/v1/leads' \--header 'Authorization: Basic XX' \--header 'Content-Type: application/json' \--data-raw '{ "campaignId": 27305, "pool": 26024, "masterData":[ { "id": 1, // field id "value": "adversus.io" // value }, { "id": 2, "value": "+1 (337) 385 5102" } ]}'
Por favor, consulte la documentación oficial de la API para conocer los detalles de cómo obtener los ID de campaña, grupo y campo.
Puede añadir los siguientes parámetros a su solicitud si es necesario:
Parámetro | Propósito |
Próxima hora de contacto | El lead está, por defecto, listo para llamar después de la inserción. Si desea programar una llamada en el futuro, establezca este parámetro de fecha/hora. |
Contactado última vez por | Si se inserta una devolución de llamada privada, este campo puede ser rellenado con el ID del usuario que debería recibir la devolución de llamada. |
Estado | El campo de estado es por defecto Sin procesar. Utilice este parámetro si desea insertar un lead con otro estado. |
Identificación externa | Las identificaciones externas pueden ser útiles cuando se integran con sistemas externos. Consulte este artículo para obtener más detalles. |