Octubre 2022 [v8.3.5] Actualización de la API de Contactos y Mensajería
¡La API 2.0 ya está aquí!
Última actualización
¡La API 2.0 ya está aquí!
Última actualización
¡Nuestra nueva API por fin está en beta pública! 🎉 Querías una API más completa para construir integraciones robustas, así que nos complace anunciar la nueva generación de la API de okeybot.com.
Para utilizar la nueva versión de la API, ve a Configuración > Integración > API para desarrolladores para generar un nuevo token de acceso y autenticar tu solicitud de API.
La nueva API se construye utilizando las convenciones de REST y está diseñada para tener una estructura de URL predecible que cumple con la última especificación de OpenAPI. Utiliza muchas características estándar de HTTP, incluidos los métodos (POST, GET, PUT, DELETE) y los códigos de respuesta de error. Todas las llamadas a la API se realizan bajo https://api.chatapi.net/v2 y todas las respuestas devuelven JSON estándar.
Con la anterior iteración de la API, se necesitaba un token de acceso específico para cada canal y los ID de contacto de los contactos de ese canal.
La nueva API funciona a nivel de espacio de trabajo, en lugar de a nivel de canal. Esto significa que sólo necesitas un único token de acceso para todas las acciones dentro del mismo espacio de trabajo, como enviar mensajes a los contactos en diferentes canales. También puede utilizar cualquiera de los identificadores (ID de contacto, número de teléfono y dirección de correo electrónico) para actualizar los datos de un contacto o enviarle un mensaje.
¡Ahora cubrimos todos los casos de uso! Con la nueva API, puede:
Crear nuevos contactos.
Actualizar los contactos existentes.
Enviar un mensaje a los Contactos (🤩 te sorprenderán los tipos de mensajes que soportamos ahora).
Asignar o desasignar conversaciones.
Abrir o cerrar conversaciones.
Añadir comentarios a una conversación.
Puede consultar nuestra documentación de la API aquí para explorar todos los puntos finales disponibles con las respectivas respuestas de la API.
Los usuarios de la API heredada no se preocupen, pueden seguir utilizando nuestros puntos finales heredados, ya que siguen siendo estables y soportados hasta nuevo aviso.