Actualizar un Contacto

Aquí encontrarás la información de como actualizar un contacto por el API de B2Chat.

Este servicio ofrece la posibilidad única de mantener actualizados tus contactos en B2Chat, sincronizando eficazmente la información proveniente de otros sistemas. Esta integración continua asegura que todos los datos relevantes para facilitar la atención o realizar acciones específicas hacia el contacto estén siempre al día. Con esta herramienta, puedes mejorar significativamente la gestión de la comunicación, asegurando que la interacción con cada contacto sea personalizada y basada en la información más reciente. Además, facilita el seguimiento eficiente de las interacciones previas, permitiendo un enfoque más estratégico y coherente en tus estrategias de engagement y fidelización de clientes.

El servicio cuenta con una serie de características:

• Permite actualizar un contacto a la vez.

• Es posible actualizar los campos estándar y personalizados de un contacto.

• Para actualizar un contacto se debe realizar conociendo el ID del contacto, por lo tanto el valor ID de contacto es requerido en la solicitud.

• Solo se actualizan los campos que se envíen en la solicitud, tanto campos estándar como personalizados.

Buena practica: Si no es conocido el ID del contacto primero puedes obtenerlo realizando una búsqueda en el servicio "Recuperar contactos" y tomar el ID del contacto que deseas actualizar.

Endpoint para actualizar un contacto

https://api.b2chat.io/contacts/{{contact_id}}' 

Actualizar contacto

PATCH https://api.b2chat.io/contacts/{{contact_id}}

Este servicio te permitirá actualizar los campos estándar y personalizados de un contacto.

Query Parameters

Name	Type	Description
contact_id	Numerico	Hace referencia al ID del contacto que deseas actualizar.

Headers

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

Request Body

Name	Type	Description
contact.mobile	Numero movil	Debe ser un campo de tipo movil valido para WhatsApp con el formato +<código_país><número_de_móvil> p.ej. [phone]
skip_required_custom_attributes	Boolean	Al colocarlo en FALSE el contacto no se actualiza si no tiene un campo personalizado requerido. En TRUE permite actualizar un contacto aunque no se envíe en el body los campos personalizados requeridos. Por defecto esta en TRUE.
contact.fullname	String	Hace referencia al nombre del contacto.
contact.landline	Numerico	Permite incluir el teléfono fijo.
contact.email	String	Campo correo electrónico
contact.identification	String	Campo asociado a la identificacion del contacto maximo 200 caracteres.
contact.address	String	Campo asociado a la direccion del contacto maximo 200 caracteres.
contact.country	ISO Code	Campo que recibe el codigo ISO del pais, revisar codigos ISO en (https://countrycode.org)
contact.cityName	String	Campo asociado a la ciudad del contacto maximo 200 caracteres.
contact.company	String	Campo asociado a la compania o empresa del contacto, maximo 200 caracteres.
contact.custom_attribute	Array	Permite enviar un arreglo de campos personalizados creados previamente en la administración de B2Chat, el arreglo debe tener el nombre del campo y el valor de cada campo personalizado que se desee registrar al contacto.

200: OK Respuesta exitosa

{
    "id": 123456789,
    "fullName": "Jhon Doe",
    "email": "[e-mail]",
    "address": "Cra 107",
    "company": "B2Chat",
    "identification": "0123456789",
    "mobile": "[phone]",
    "landline": "277223355",
    "city": "Medellin",
    "custom_attributes": [
        {
            "id": 9,
            "name": "Mascota",
            "value": "Dog"
        }
    ]
}

curl --location --request PATCH 'https://api.b2chat.io/contacts/{{contact_id}}' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{token}}' \
--data-raw '{
    "skip_required_custom_attributes": false,
    "contact": {
        "fullName": "John Doe",
        "email": "[e-mail]",
        "landline": "277223355",
        "mobile": "[phone]",
        "identification": "0123456789",
        "address": "Cra 107",
        "cityName": "Medellin",
        "company": "B2Chat",
        "custom_attributes": [
      {"name": "mascota", "value": "Dog" }
      
    ]
    }
}'