Importar muchos contactos en bloque | Convos

La importación de muchos contactos en bloque te permitirá mantener tu lista de contactos actualizada rápidamente.

Requisitos:

Tu X-Tenant.
https://help.convos.la/es/articles/8452332-x-tenant

Un token con la habilidad de "Audience".
https://help.convos.la/es/articles/8306556-token-de-acceso

Configuración de la request:

Descripción	Importar muchos contactos en bloque.
HTTP Method	POST
Headers	X-Tenant: {YourXTenant} Authorization: Bearer {YourToken}
URL	https://api.convos.la/consumer/contacts/import/bulk
Paginación y filtrado (ejemplo)	*none*
Parámetros adicionales	Campo: Field: import_type Values: subscribed \| unsubscribed Type: String Default: subscribed Descripción: Este parámetro permite realizar la importación para desuscribir contactos, por defecto siempre será para importar contactos nuevos o actualizar existentes. { "import_type": "unsubscribed" } Campo: Field: subscribe_force Values: true \| false Type: Boolean Default: false Descripción: Este parámetro permite volver a suscribir un número de teléfono cuando el mismo se encuentra desuscripto actualmente. { "subscribe_force": true } Campo: Field: try_fix_cellphones Values: true \| false Type: Boolean Default: false Descripción: Este parámetro permite corregir automáticamente el número de teléfono cuando no está en formato internacional, de modo que el contacto pueda importarse correctamente. { "try_fix_cellphones": true }

Ejemplos:

Descripción	Importa muchos contactos en bloque de manera general.
JSON request (ejemplo)	{ "contacts": [ { "cellphone": "<cellphone1>", "fields": [ { "id": 1, "value": "<value1>" } ] }, { "cellphone": "<cellphone2>", "fields": [ { "id": 1, "value": "<value2>" } ] } ] }
JSON response (ejemplo)	{}

Descripción

Importa muchos contactos en bloque a un grupo específico o varios grupos.

JSON request (ejemplo)

{
  "group_id": [<Group ID 1>, <Group ID 2>],
  "contacts": [
    {
      "cellphone": "<cellphone1>",
      "fields": [
        {
          "id": 1,
          "value": "<value1>"
        }
      ]
    },
    {
      "cellphone": "<cellphone2>",
      "fields": [
        {
          "id": 1,
          "value": "<value2>"
        }
      ]
    }
  ]
}

JSON response (ejemplo)

{}

Descripción

Importa muchos contactos en bloque a un grupo por nombre, en caso de no existir el grupo se creará en el momento.

JSON request (ejemplo)

{
  "group_name": "<Group Name>",
  "contacts": [
    {
      "cellphone": "<cellphone1>",
      "fields": [
        {
          "id": 1,
          "value": "<value1>"
        }
      ]
    },
    {
      "cellphone": "<cellphone2>",
      "fields": [
        {
          "id": 1,
          "value": "<value2>"
        }
      ]
    }
  ]
}

JSON response (ejemplo)

{}