Importar contactos

URL de la API

URL a la que se envían las solicitudes HTTP:

https://portal.bulkgate.com/api/1.0/address-book/import

Nota

Si la solicitud no llega a su destino, repítala en el servidor de respaldo backup1.bulkgate.com.

Métodos HTTP admitidos

POST - application/json

POST /api/1.0/address-book/import HTTP/1.1 Host: portal.bulkgate.com Content-Type: application/json

Tabla de parámetros

NOMBRE DEL PARÁMETRO	VALOR	OBLIGATORIO	VALOR PREDETERMINADO
application_id	ID de la aplicación	Sí	-
application_token	Token de la aplicación	Sí	-
groups	Array de ID de los grupos a los que se añadirán los contactos	No	-
group_name	Los contactos importados se añadirán a un grupo nuevo con este nombre	No	-
data	Datos del contacto	Sí	Array de objetos Data
category	Agenda de contactos con la que se trabaja. De forma predeterminada, la principal de la cuenta.	No	`main`
duplicity_action	Qué hacer con un contacto que ya existe: `restrict` (rechazar), `skip` (omitir), `update` (rellenar los campos vacíos), `rewrite` (sobrescribir).	No	`skip`

Objeto Data

NOMBRE DEL PARÁMETRO	VALOR	OBLIGATORIO	VALOR PREDETERMINADO
type	Tipo de contacto (persona/empresa)	No	-
phone_mobile	Número de teléfono principal	No	-
title_before	Título antes del nombre	No	-
first_name	Nombre	No	-
last_name	Apellidos	No	-
title_after	Título después del nombre	No	-
gender	male / female / transgender / agender / non_binary / unknown	No	unknown
company_name	Nombre de su empresa	No	-
email	Correo electrónico	No	-
url	URL de su sitio web	No	-
street1	1. Dirección (calle)	No	-
street2	2. Dirección (calle)	No	-
city	Ciudad	No	-
zip	Código postal	No	-
state	Provincia/estado	No	-
country	Código de país en formato ISO 3166-1 alpha-2	No	`null`
company_number	Número de identificación de la empresa	No	-
company_vat	NIF/IVA de la empresa	No	-
note	Nota	No	-
custom_field_0	Campo personalizado	No	-
custom_field_1	Campo personalizado	No	-
custom_field_2	Campo personalizado	No	-
custom_field_3	Campo personalizado	No	-
custom_field_4	Campo personalizado	No	-
custom_field_5	Campo personalizado	No	-
custom_field_6	Campo personalizado	No	-
custom_field_7	Campo personalizado	No	-
custom_field_8	Campo personalizado	No	-
custom_field_9	Campo personalizado	No	-

Ejemplo de solicitud

POST /api/1.0/address-book/import HTTP/1.1 Host: portal.bulkgate.com Content-Type: application/json { "application_id": 451, "application_token": "NKN02TWE6NfBkfl-your-secret-token-Wf05GaqLIWLW4aBj", "groups": [1, 2], "group_name": "Talos 1", "data": [ { "first_name": "Morgan", "last_name": "Yu", "phone_mobile": "789456123" }, { "first_name": "Alex", "last_name": "Yu", "phone_mobile": "123456789" } ] }

Respuesta

En caso de éxito:

{ "data": { "message": "contacts_have_been_imported", "imported": 3, "groups": [1,2,3] } }

En caso de error:

{ "type": "no_valid_contacts_found", "code": 400, "error": "No valid contacts found", "detail": null }

Donde:

type y error (descripción del error) se encuentran en la tabla de tipos de error
code es el código de error HTTP
detail es información adicional sobre el error

¿Le ha resultado útil esta página?

Preguntar a la IA Copiado