Cómo eliminar tags de contactos en masa vía API

Cuándo usar

• Necesitas eliminar tags de múltiples contactos a la vez sin tener que abrir cada contacto manualmente
• Estás ejecutando una rutina de limpieza o corrección de tags en tu base de contactos
• Quieres mantener la base organizada después de una campaña o migración

Requisitos previos

• API Key (API_TOKEN) a mano — consulta Cómo encontrar tu API Key en Cloud Chat

• El ACCOUNT_ID de la cuenta

• Cada contacto debe tener al menos un identificador entre identifier, email o phone_number

Endpoint

DELETE https://cloudchat.cloudhumans.com/api/v1/accounts/{ACCOUNT_ID}/contacts/delete_tags

Headers

Cuerpo de la solicitud

El body debe contener un único campo, contacts, que es un array de objetos. Cada objeto representa un contacto y debe contener:

*Se debe informar al menos un identificador para localizar el contacto.

Ejemplo de solicitud

curl --request DELETE \
  --url 'https://cloudchat.cloudhumans.com/api/v1/accounts/ACCOUNT_ID/contacts/delete_tags' \
  --header 'api_access_token: API_TOKEN' \
  --header 'content-type: application/json' \
  --data '{
    "contacts": [
      {
        "identifier": 123,
        "tags": ["tag-de-massa-1","tag-de-massa-2"]
      },
      {
        "email": "[email protected]",
        "tags": ["tag-de-massa-2","tag-de-massa-3"]
      },
      {
        "phone_number": 5551000000000,
        "tags": ["tag-de-massa-1","tag-de-massa-3"]
      }
    ]
  }'

Cómo se localiza el contacto

El sistema busca el contacto en este orden:

1. identifier (primero)

2. email (segundo)

3. phone_number (tercero)

Sobre phone_number

Observaciones

• Para eliminar el contacto (no solo quitar tags): Cómo crear, actualizar y eliminar contactos vía API

• Para crear o actualizar contactos (incluida la gestión de tags con tags_add y tags_remove granulares): Cómo importar contactos en masa vía API

• Para actualizar atributos personalizados (no tags) en conversaciones: Cómo actualizar atributos personalizados en conversaciones vía API

• Visión general de todas las APIs disponibles: Guía Maestra — Cómo acceder y operar datos de Cloud Chat vía API