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.

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"
    }
]'
PreviousTags de ContactosNextEliminar Tags de Contactos

Last updated