Toma nota
Con ActiveCampaign, puede usar la API Bulk Contact Importer para cargar un gran número de contactos en su cuenta con una sola llamada a la API.
Toma nota
- La API de importador de contactos masivos está disponible en todos los planes ActiveCampaign
- Esta característica es para usuarios avanzados que están familiarizados con la API y se sienten cómodos al usarlo para importar contactos
- Estas operaciones incluyen:
Acerca de la API de importador de contactos a granel
El importador de contactos a granel está diseñado para realizar operaciones en grandes cantidades de contactos a la vez. Estas operaciones incluyen:
- Creación de nuevos contactos
- Actualización de contactos existentes
- Establecer campos en los contactos
- Etiquetado de contactos
- En su lugar, las actualizaciones de contacto deben recopilarse en lotes más grandes e importarse como un grupo.
Nota
El importador de contactos masivos no está diseñado para admitir operaciones frecuentes que impliquen un pequeño número de contactos o para sincronizar actualizaciones en tiempo real desde una base de datos externa. En su lugar, las actualizaciones de contacto deben recopilarse en lotes más grandes e importarse como un grupo. Los contactos se pueden importar en lotes de hasta 250 artículos.
Si necesita cargar 10 o menos contactos a la vez, utilice la funcionalidad Contactos de nuestra API V3 de ActiveCampaign.
Limitación de velocidad
El proceso de importador a granel está optimizado para la carga de listas más grandes de contactos. La ejecución de solicitudes frecuentes que implican un pequeño número de contactos requiere una sobrecarga significativa y puede afectar al rendimiento del importador’s. Como resultado, aplicamos los siguientes límites de tarifas en la API de importador de contactos masivos:
- Para las solicitudes que contienen un solo contacto, hay un límite de 20 solicitudes por minuto
- Para las solicitudes que contienen varios contactos, hay un límite de 100 solicitudes por minuto
Se recomienda que todos los usuarios intenten procesar por lotes las actualizaciones en grupos lo más grandes posible antes de iniciar una importación.
Limitación del tamaño de la carga útil
El tamaño de carga útil de una sola solicitud de bulk_import debe ser inferior a 400000 bytes.
Contactos omitidos
Los contactos deben cumplir todos los criterios siguientes para poder crearse o actualizarse con esta API:
- Es posible que los contactos importados no excedan el límite de su cuenta
- El contacto debe tener una dirección de correo electrónico
Si los contactos no cumplen todos estos requisitos, el importador los omitirá.
- La dirección de correo electrónico de de los contactos no debe estar en una lista de exclusión
- El correo electrónico de los contactos no debe estar en una lista de direcciones de correo electrónico rebotadas
- El contacto no debe haber cancelado la suscripción a una lista a la que la importación los agregaría
Si los contactos no cumplen todos estos requisitos, el importador los omitirá.
Documentación de API
PUBLICAR https://youraccountname.api-us1.com/api/3/import/bulk_import
Estructura de la solicitud
JSON
{
"contacts": [{"email": "someone@somewhere.com","first_name": "Jane","last_name": "Doe","phone": "123-456-7890","customer_acct_name": "ActiveCampaign","tags": ["dictumst aliquam augue quam sollicitudin rutrum",],"fields": [
{
"id": 1,
"value": "foo"},
{"id": 2,"value": "foo|| bar|| baz"}
],
"subscribe": [{"listid": 1}, {"listid": 2}],"unsubscribe": [{"listid": 3}],}
],"callback": <opcional, ver="ver" abajo="abajo">
}
Respuesta
200 OK
{
"Success":1,"queued_contacts":1,"batchId":"0641fbdd-f62f-4c2c-ba02-3a83d5d11ac9",
"message":"Contact import queued"
}
400 Bad Request
{
"Success":0,
"message":"La carga útil JSON no pasó la validación. Corrija failureReasons y vuelva a intentarlo. La importación no se puso en cola para su procesamiento.",
"failureReasons":["La carga útil debe contener un campo 'contactos'"]
}</opcional,>
Params Corporales
Matriz de contactos* (objeto)
Matriz de objetos que contiene información sobre un único contacto. Se pueden incluir hasta 250 contactos en una sola solicitud. Cada contacto puede contener los siguientes campos:
-
email* (cadena)
El correo electrónico del contacto. - first_name (cadena)
El nombre del contacto. - last_name (cadena)
El apellido del contacto. -
teléfono (cadena)
El número de teléfono del contacto. - customer_acct_name (cadena)
El nombre de la cuenta del contacto. -
tags array (cadena)
Cada cadena de la matriz se agregará como una sola etiqueta al contacto. Se crearán nuevas etiquetas si aún no existen. -
fields array (objeto)
Una lista de campos personalizados para aplicar al contacto. Cada campo debe contener dos campos: Cada contacto puede tener hasta N campos personalizados. -
id* (número)
El identificador del campo personalizado. El identificador que ActiveCampaign les asigna debe hacer referencia a los campos personalizados. Puede recuperar el número de ID de un campo personalizado mediante la llamada a la API "Enumerar todos los campos personalizados". -
value* (string)
El valor del campo personalizado. Se pueden rellenar varios valores para campos de varios valores separando los diferentes valores por el delimitador de doble tubería (“||”). -
subscribe array (objeto)
Matriz de listas a las que suscribir el contacto. Es posible que los contactos no se suscriban a listas de las que han cancelado su suscripción anteriormente. Cada objeto de lista contiene un único campo. - Cada objeto de lista contiene un único campo.
listid* (número)El identificador de la lista de la que se va a cancelar la suscripción del contacto. El identificador que ActiveCampaign les asigna debe hacer referencia a las listas.
Puede encontrar el ID de la lista haciendo clic en la lista en su cuenta de ActiveCampaign y luego viendo la barra de URL. Se verá algo como esto: /app/contacts/?listid=19&status=1
También puede recuperar el número de ID de una lista mediante la llamada a la API "Recuperar todas las listas". -
unsubscribe array (objeto)
Matriz de listas a las que cancelar la suscripción del contacto. Cada objeto de lista contiene un único campo.
listid* (número)El identificador de la lista de la que se va a cancelar la suscripción del contacto. El identificador que ActiveCampaign les asigna debe hacer referencia a las listas.
Puede encontrar el ID de la lista haciendo clic en la lista en su ActiveCampaign y luego viendo la barra de URL. Se verá algo como esto: /app/contacts/?listid=19&status=1
También puede recuperar el número de ID de una lista mediante la llamada a la API "Recuperar todas las listas".
Callbacks
El punto de conexión de contacto masivo tiene una función de devolución de llamada para notificar a los usuarios cuando se completa una importación. Incluya la siguiente información en una solicitud de importación de contacto para utilizar esta característica:
JSON
{
"contactos": [ ... incluir contactos aquí ... ],"callback": {"url": "www.your_web_server.com","requestType": "POST","detailed_results": "true","params": [{"key":"","value":""}]"headers": [
{
"key":"",
"value":""}]
}}
- url (cadena)
El extremo de la URL al que el importador realizará una solicitud una vez completada la importación. -
requestType (cadena)
Se puede establecer en "GET" o "POST". Determina el tipo de solicitud HTTP que se enviará al punto de conexión especificado. - detailed_results (cadena)
Cuando se establece en "true" y el parámetro requestType se establece en "POST", la devolución de llamada incluirá el número de éxitos y errores en la solicitud de origen, así como una matriz de mensajes de error para cada contacto fallido. -
params (matriz)
Lista de parámetros que se van a incluir en la solicitud de devolución de llamada. Agregue cada parámetro en forma de un par clave-valor. Para una solicitud GET, cada parámetro se anexará al final de la dirección URL en una cadena de búsqueda. Para una solicitud POST, los parámetros se incluirán en el cuerpo de la solicitud. - Encabezados (matriz)
- Una lista de encabezados para incluir en la solicitud de devolución de llamada. Agregue cada encabezado en forma de un par clave-valor.
Ejemplos
Recibir una notificación
{
"contactos": [ ... incluir contactos aquí ... ],"callback": {"url": "www.yourwebsite.com/the/api/to/hit","requestType": "GET","params": [{"key":"msg","value":"hello"}]"headers": [
{"key":"",
"value":""}
]
}}
Params se anexará a la dirección URL como parámetros de búsqueda en el caso de un “ GET” Petición. Los encabezados se aplicarán a la solicitud antes de enviarla. Este punto de conexión acepta cualquier valor de cadena para claves y valores para parámetros y encabezados.
Resultado:
OBTENER www.yourwebsite.com/the/api/to/hit?msg=hello
Publicación de un mensaje
{
"contactos": [ ... incluir contactos aquí ... ],"callback": {"requestType": "POST","params": [{"key":"msg","value":"Import completed"}]"headers": [
{"key":"Authorization",
"value":"Bearer 4u1h_t0k3N"}]
}}
Resultado:
OBTENER www.yourwebsite.com/the/api/to/hit
JSON
[
{"key":"msg","value":"Importación completada"}
]
Importar resultados con mensajes de error
{
"contactos": [ ... incluir contactos aquí ... ],"callback": {"requestType": "POST","detailed_results": "true","headers": [{"key":"",
"value":""}]
}}
Cuando el “detailed_results” parámetro se establece en " True", la devolución de llamada incluirá:
- Un objeto JSON que contiene los parámetros especificados
- Otros tres campos en la respuesta que pueden ayudar con la supervisión y depuración
Resultado:
OBTENER www.yourwebsite.com/the/api/to/hit
JSON
{
"Success":1,"Failures":0,
"failure_reasons":[]
}