Requiere un acceso de usuario de la API con rutas de administración o personalizadas. |
Este artículo explicará cómo insertar/actualizar contactos de forma masiva utilizando el puntofinal/importaciones. El punto final admite la funcionalidad de importación extendida que se conoce desde la interfaz de usuario, como la doble comprobación y el enriquecimiento de los contactos existentes.
Para entender mejor las posibilidades con el importador de datos, puede echar un vistazo al artículo que explica cómo cargar leads a través de la interfaz de usuario.
Una importación es iniciada enviando una solicitud POST a crear /imports punto final - por ejemplo:
{ "poolId": 25528, "match": { "fields": [ 2 ], "blacklist": [] }, "updateFields": [ 1, 2, 3 ], "callbackUrl": "https://your-custom-callback-url.dev"}En este caso, estamos indicando al importador que inserte los contactos en el grupo con el ID 25528. Este es el único parámetro requerido si estás haciendo una carga. Si quieres utilizar más funciones, como el control de duplicados, hay que añadir algunos parámetros más:
Comprobación de los duplicados de importación
Defina los campos $.match. con los ID de los que desea ejecutar la doble comprobación. Puede incluir cualquier contacto existente en la doble comprobación añadiendo uno o varios ID de grupo a $.match.blacklist.
Enriquecer los contactos existentes
En lugar de omitir por completo los contactos existentes durante la doble comprobación, los campos permitidos para el enriquecimiento de datos deben definirse en $.updateFields.
Dado que se trata de un proceso asíncrono, puede ser necesaria una devolución de llamada al integrarse en sistemas externos. La URL se puede añadir a $.callbackUrl.
Para más información, consulte la página de documentación oficial.
La solicitud devolverá una respuesta con el ID del importador, por ejemplo:
{ "id": 523231, "state": "init", "match": { "fields": [ 2 ], "blacklist": [ 25528 ] }, "updateFields": [ 1, 2, 3 ], "poolId": 25528}El ID devuelto se utiliza ahora para rellenar los registros a la solicitud de importación llamando al endpoint /imports/{id}/insert; en este caso /imports/523231/insert.
La solicitud debería incluir sus registros de contacto en el cuerpo, según la documentación.
[ { "data": { "1": "Peter", "2": "12345678", "3": "8000" } }, { "data": { "1": "Martin", "2": "87654321", "3": "9000" } }]Por último, inicie la solicitud de importación llamando a /imports/{id}/start.