Saltar al contenido principal
La API de Replier permite que tu propio código o una herramienta de automatización haga lo mismo que tú en Replier: listar espacios de trabajo, cuentas y publicaciones, crear y cambiar automatizaciones, leer resultados y contactos, y enviar respuestas pendientes o de automatizaciones únicas. Para usar Replier desde ChatGPT, Claude u otra herramienta de IA, usa las conexiones de IA. La referencia de la API (en inglés) muestra cada endpoint con sus parámetros y respuestas.

​
Crear una clave de API

  1. En Replier, abre el menú de tu cuenta y elige Gestionar la cuenta → Integraciones.
  2. En Claves de API, selecciona Crear clave de API.
  3. Escribe un nombre que reconozcas después, elige su acceso y selecciona Crear clave.
  4. Copia la clave. Replier solo la muestra una vez.
Quien tenga la clave puede usar Replier en tu nombre, así que no la pongas en código que compartas ni en el navegador. Si se filtra, elimínala y crea otra. Una clave que solo puede ver tus datos se rechaza cuando intenta cambiar algo. Una clave que también puede hacer cambios puede crear, editar, activar o desactivar y eliminar automatizaciones, guardar tus textos predeterminados, reordenar la cola de la próxima publicación, subir fotos de respuesta y enviar respuestas pendientes y de automatizaciones únicas. En ambos casos, la clave actúa con tu rol en cada espacio de trabajo, así que no puede hacer más que tú.

​
Hacer una solicitud

Envía la clave como bearer token a https://api.usereplier.com/v1:
Las demás solicitudes se hacen en un espacio de trabajo. Usa un id de esa lista:
Las solicitudes que cambian algo envían JSON:
Las automatizaciones creadas o cambiadas con la API tienen los mismos límites que en Replier: hasta 24 destinos, tres botones, una foto opcional y flujos de mensajes en espacios de trabajo Studio.

​
Errores

Una solicitud rechazada responde con un estado HTTP y un cuerpo como este:
code no cambia; message es una explicación en inglés y su redacción puede cambiar. Algunos errores añaden otros campos, como la automatización que ya tiene la publicación que elegiste.

​
Reintentar con seguridad

Las solicitudes que cambian algo aceptan el encabezado Idempotency-Key. Envía un valor aleatorio nuevo, como un UUID, para cada operación y el mismo valor al reintentarla. Un reintento con el mismo valor devuelve el primer resultado en lugar de crear una segunda automatización o enviar las respuestas dos veces. Enviar respuestas pendientes, de comentarios anteriores o de automatizaciones únicas, y crear una automatización única, requieren el encabezado; sin él, la solicitud se rechaza con IDEMPOTENCY_KEY_REQUIRED.
Para no sobrescribir el cambio de otra persona, envía expected_version con la versión que leíste. Si la automatización cambió desde entonces, la solicitud se rechaza con VERSION_CONFLICT. Es obligatorio al eliminar una automatización.

​
Cambios en la API

Dentro de /v1, Replier solo añade: endpoints nuevos, parámetros opcionales nuevos, campos de respuesta nuevos y valores nuevos en campos de estados o motivos. Ignora los campos y valores que no conozcas. Un cambio que rompería el código existente llegará como /v2.

​
Pausar o eliminar una clave

En Gestionar la cuenta → Integraciones, cada clave muestra su acceso y cuándo se usó por última vez. Elige Pausar acceso para rechazar sus solicitudes hasta que elijas Reanudar acceso. Elige Eliminar clave para quitarla definitivamente; el código que la usa pierde el acceso de inmediato. Las automatizaciones que creó siguen funcionando.