Adicionar Tags a un Contacto

Este servicio permite asignar tags a un contacto, dando la oportunidad de categorizarlos y agruparlos por intereses o comportamientos comunes, para lograr tomar decisiones y realizar acciones por esta agrupación de contactos. Facilita la identificación de tendencias y patrones dentro de tu base de datos, permitiendo una segmentación más precisa para campañas de marketing y comunicación. Además, mejora la gestión de relaciones con clientes al personalizar la interacción basada en sus intereses y necesidades específicas, optimizando así la eficiencia operativa y la satisfacción del cliente.

Recuerda que los tags pueden ser creados por un usuario administrador dentro de B2Chat

El servicio tiene las siguientes características:

• Permite asignar un grupo de tags al contacto, enviando el nombre de las etiquetas en la solicitud.

• La asignación se hace por un contacto a la vez.

Endpoint para asignar tags a un contacto

https://api.b2chat.io/contacts/{{contact_id}}/tags?tag_actions={{config}}

Asignar tags a un contacto

POST https://api.b2chat.io/contacts/{{contact_id}}/tags?tag_actions={{config}}

Servicio que permite asignar un tag o un grupo de tags a un contacto

Query Parameters

Name	Type	Description
contact_id*	Numerico	Representa el ID del contacto como query params
tag_actions	String	Es una configuración del comportamiento de los tags asignados, puede tener dos valores: SKIP_TAGS: Cuando un tag no es encontrado o no está en estado ACTIVO se ignora y no se asocia el tag al contacto. ASSIGN_TAG: Si un tag no es encontrado se crea el tag y se asocia el tag al contacto, en caso de estár inactivo solo se debe asociar al contacto.

Headers

Name	Type	Description
Content-Type*	application/json
Authorization*	Bearer {{token}}

Request Body

Name	Type	Description
Array de tags*	Array	Es un arreglo de nombre de tags que se quiere asignar a un contacto.

200: OK Respuesta exitosa

Cuando se envia el valor ASSIGN_TAG, el tag se crea con el nombre que se recibe, el color debe ser #ffffff y el emoji debe ser el siguiente 😀 y en estado INACTIVO

Ejemplo 1: Asigno un solo tag a un contacto.

curl --location POST 'https://api.b2chat.io/contacts/{{contact_id}}/tags?tag_actions={{config}}' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{token}}' \
--data '[
    {
        "name": "tag1"
    }
]'

Ejemplo 2: Asigno varios tags a un contacto.

curl --location POST 'https://api.b2chat.io/contacts/{{contact_id}}/tags?tag_actions={{config}}' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{token}}' \
--data '[
    {
        "name": "tag1"
    },
    {
        "name": "tag2"
    },    
    {
        "name": "tag3"
    }
]'