1980TIC Cloud
Buscar…
⌃K
📥

APIV2

La URL para hacer uso de API v2 cambia a https://api.chatapi.net/v2. El protocolo HTTPS es OBLIGATORIO
Esta versión de API seguirá las convenciones de RESTful cuando seaposible, y la mayoría de las operaciones pueden ser realizadas a través de solicitudes GET, POST, PUT y DELETE. Los cuerpos de las solicitudes y las respuestas se codifican como JSON.

Autenticación

Se hace uso de un Token de Acceso API para autenticar las solicitudes. Puedes ver y gestionar tu token de acceso en el módulo Configuración > Integración > API para desarrolladores.
Puedes generar hasta 10 tokens de acceso por espacio de trabajo. Cada organización está limitada a generar un máximo de 10 tokens de acceso.
La autenticación se pasa a través del encabezado de Autorización con cada solicitud.

Tasa de límites

Se estableció una limitación en la cantidad de solicitudes que se pueden enviar por cada end-point. Los límites se aplican a nivel de organización.
Las respuestas de la API contienen cabeceras de límite de velocidad útiles para comprobar las solicitudes restantes.
Nombre
Descripción
Retry-After
Cantidad de segundos antes de que puedas volver a enviar una solicitud
X-RateLimit-Limit
Cantidad de solicitudes permitidas para este end-point
X-RateLimit-Remaining
Cantidad de solicitudes restantes disponibles en este end-point

Límites

​
Nombre de API
Endpoint
Solicitudes por segundo
Enviar un mensaje
/contact/{identifier}/message
10
Obtener un mensaje
/contact/{identifier}/message/{messageId}
15
Crear un comentario
/contact/{identifier}/comment
10
Obtener un contacto
/contact/{identifier}
10
Crear, actualizar o eliminar un contacto
/contact/{identifier}
5
Fusionar dos contactos
/contact/merge
5
Crear o actualizar un contacto
/contact/create_or_update/{identifier}
5
Añadir o eliminar etiquetas
/contact/{identifier}/tag
5
Listar canales por contacto
/contact/{identifier}/channels
5
Obtener el canal de un contacto
/contact/{identifier}/channel/{channelId}
10
Asignar/Desasignar una conversación
/contact/{identifier}/conversation/assignee
5
Abrir/Cerrar una conversación
/contact/{identifier}/conversation/status
5
Listar canales en un espacio
/space/channel
5
Listar notas de cierre
/space/closing_notes
5
Listar usuarios por espacio
/space/user
5
Obtener un usuario de un espacio
/space/user/{id}
10
Crear campo de contacto
/space/contact_field
5
Obtener campo de contacto
/space/contact_field/{id}
10
Listar campos de contacto
/space/contact_field
5

Códigos de respuesta HTTP

​
Codigo de estado
Descripción
200 Ok
La solicitud se ha realizado con éxito y se ha proporcionado la respuesta adecuada.
201 Created
La solicitud se ha cumplido, dando lugar a la creación de un nuevo recurso.
400 Bad request
Hay un error en el lado del cliente y, como resultado, el servidor no puede devolver una respuesta. Por ejemplo, el correo electrónico, el teléfono o el ID del contacto no son válidos.
401 Unauthorised
El token de acceso no es válido.
404 Not Found
Dado el token de acceso utilizado, el recurso no existe.
429 Too many requests
Esta solicitud excede el número de solicitudes permitidas. Reduzca la velocidad y vuelva a intentarlo.
502/504 timeouts
El servidor ascendente no ha proporcionado una respuesta oportuna al segundo servidor, que actualmente sirve de pasarela o proxy. Como resultado, no puede proporcionar una respuesta al cliente.
503
El servidor no puede procesar la solicitud porque está sobrecargado o está en mantenimiento.