v1 · 14 endpoints · instantreply.up.railway.app
WhatsApp + Instagram
REST API, v1.
Bearer auth. Cursor pagination. Idempotency keys. Webhooks firmados. La API que tu equipo habría construido si tuviera el fin de semana.
Elige el runtime
import InstantReply from '@instantreply/node'
const ir = new InstantReply({ apiKey: process.env.IR_API_KEY })
for await (const c of ir.conversations.list.autoPaginate({ status: 'active' })) {
if (c.last_message_preview?.includes('refund')) {
await ir.conversations.update(c.id, { tags: ['priority:refund'] })
}
}Superficie v1
Catorce endpoints, un header de auth.
- GET
/v1/conversations - GET
/v1/conversations/:id - PATCH
/v1/conversations/:id - GET
/v1/conversations/:id/messages - POST
/v1/conversations/:id/messages - GET
/v1/contacts - GET
/v1/contacts/:id - PATCH
/v1/contacts/:id - GET
/v1/channels - GET
/v1/analytics/summary - GET
/v1/usage - GET
/v1/webhooks - POST
/v1/webhooks - DELETE
/v1/webhooks/:id
Diseño
Decisiones aburridas, a propósito.
- 01
Cursor pagination, siempre
Cada endpoint de lista devuelve has_more y next_cursor. Sin records perdidos bajo carga, sin off-by-one.
- 02
Idempotency-Key en POST
Pasa un UUID y reintenta seguro por 24 horas. Los side effects disparan exactamente una vez.
- 03
X-Request-Id en cada respuesta
Pega el ID en soporte y trazamos exactamente la llamada, la respuesta y la llamada downstream.
- 04
Errores con forma
Mismo envelope JSON en cada falla. code, message, doc_url, request_id. Sin nulls sorpresa.
Errores
Un solo formato, siempre.
Sin flags de éxito anidados. Sin mezclas de casing. Sin 200s silenciosos en falla. Si la llamada se rompió, el body te dice exactamente qué llamada, qué esperaba y dónde están los docs.
// 422 Unprocessable Entity
{
"error": {
"code": "INVALID_PLATFORM",
"message": "Channel 'tiktok' is not yet supported on v1.",
"doc_url": "https://www.instantreply.co/api-docs#errors",
"request_id": "req_8f2a0b1c"
}
}Sin tarjeta en la prueba