Contacts

Importar un lote de contactos (máx 500). Preserva user_ns y line_id, y no toca uChat. `apply_tags` etiqueta todas las filas del lote; `on_existing` define qué pasa con los que ya existen (fill = rellenar vacíos, por defecto; overwrite = manda el archivo; skip = no tocarlos; registration = solo avanzar la misma sesión de alta). Las etiquetas siempre se suman a las que el contacto ya tenía.

El lote tope 500 filas. Lo que decide el resultado es on_existing: fill (por defecto) solo rellena lo que estaba vacío, overwrite deja mandar al archivo y skip no toca a los que ya existen. registration crea teléfonos nuevos y, para uno existente, solo acepta una etapa de la misma registration_source + registration_id, sin retrocesos y mientras la sesión siga abierta. Una reinscripción se descarta completa. Las etiquetas de apply_tags siempre se suman, nunca reemplazan las que el contacto ya tenía. Si una fila trae line_id, se valida contra las líneas WhatsApp del workspace y se conserva como metadato de origen/emisión. A diferencia de POST /contacts, no crea suscriptores en el CRM externo. line_id es metadato de origen/emisión y no divide la identidad: el mismo teléfono importado por dos líneas actualiza una sola ficha.

post/contacts/import

Request

  • Base URL: https://api.met.meteor.com.co/api/v1
  • URL: https://api.met.meteor.com.co/api/v1/contacts/import
  • Auth: one of:
    • bearer (a scheme the document does not define)
    • HTTP bearer

Request body

apply_tagsstring[]

Etiquetas que se aplican a TODAS las filas del lote, además de las que traiga la columna tags de cada fila. Es la acción masiva del import: el archivo del cliente casi nunca trae una columna de etiquetas, y sin esto la única forma de etiquetar lo importado era abrir contacto por contacto.

on_existing'fill' | 'overwrite' | 'skip' | 'registration'

Política para los contactos que ya existen. Default fill.

registration_sourcestring

Namespace de la fuente cuando on_existing=registration.

Response

successtrue required

Siempre true en una respuesta 2xx.

Example response

{
  "data": {
    "created": 412,
    "errors": [
      {
        "reason": "phone o email es obligatorio",
        "row": 17
      }
    ],
    "skipped": 8,
    "updated": 63
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.