Ir al contenido principal

Importar un único contacto

Actualizado hace más de 3 meses

La importación de contacto único te permitirá mantener tu lista de contactos actualizada.


Configuración de la request:

Descripción

Importa un único contacto.

HTTP Method

POST

Headers

X-Tenant: {YourXTenant}
Authorization: Bearer {YourToken}

URL

https://api.convos.la/consumer/contacts/import/single

JSON request (ejemplo)

Ver más abajo los ejemplos.

Paginación y filtrado

(ejemplo)

none

Parámetros adicionales

Campo:

Field: import_type

Values: subscribed | unsubscribed

Type: String

Default: subscribed

​Descripción:

Este parámetro permite realizar la importación para desuscribir contactos, por defecto siempre será para importar contactos nuevos o actualizar existentes.

{
"import_type": "unsubscribed"
}

Campo:

Field: subscribe_force

Values: true | false

Type: Boolean

Default: false

Descripción:

Este parámetro permite volver a suscribir un número de teléfono cuando el mismo se encuentra desuscripto actualmente.

{
"subscribe_force": true
}

Campo:

Field: try_fix_cellphones

Values: true | false

Type: Boolean

Default: false


Descripción:

Este parámetro permite corregir automáticamente el número de teléfono cuando no está en formato internacional, de modo que el contacto pueda importarse correctamente.

{
"try_fix_cellphone": true
}

Ejemplos:

Descripción

Importa un único contacto de manera general.

JSON request (ejemplo)

{
"cellphone": "<cellphone>",
"fields": [
{
"id": 1,
"value": "<value1>"
}
]
}

JSON response (ejemplo)

{}

Descripción

Importa un único contacto a un grupo específico o varios grupos.

JSON request (ejemplo)

{
"group_id": [<Group ID 1>, <Group ID 2>],
"cellphone": "<cellphone>",
"fields": [
{
"id": 1,
"value": "<value1>"
}
]
}

JSON response (ejemplo)

{}

Descripción

Importa un único contacto a un grupo por nombre, en caso de no existir el grupo se creará en el momento.

JSON request (ejemplo)

{
"group_name": "<Group Name>",
"cellphone": "<cellphone>",
"fields": [
{
"id": 1,
"value": "<value1>"
}
]
}

JSON response (ejemplo)

{}

¿Ha quedado contestada tu pregunta?