Saltar al contenido
AchaduDevelopers
Developers/API/message_reply
Bandeja de entrada

Preparar respuesta

Registra una respuesta de salida para su entrega por el conector de canal.

POST/inbox/conversations/{id}/replyinbox:write
COMPORTAMIENTO

El cambio se valida y persiste en la cuenta clave antes de responder. Consulta el recurso devuelto como fuente de verdad.

EFECTO

Puede cambiar el recurso y emitir el evento de dominio correspondiente.

REPETICIÓN

En caso de falla de la red, confirme el estado del recurso antes de volver a intentarlo. Rehaga automáticamente solo 429 y 5xx con retroceso y fluctuación.

Solicitar

idstring · pathIdentificador de recursos.minLength 2 · maxLength 100obligatorio
contentstring · bodyContenido de la respuesta.maxLength 6000obligatorio
typestring · bodyTipo de mensaje.opcional
media_urlstring · bodyMedios opcionales.uriopcional
offer_idstring · bodyOferta contextual.opcional
use_duboolean · bodyMarcar a DU como autor.opcional
AuthorizationBearer ach_live_...
Acceptapplication/json
Alcanceinbox:write

Ejemplo ejecutable

curl
curl -X POST 'https://achadu.com/api/v1/inbox/conversations/resource_id/reply' \
  -H 'Authorization: Bearer ach_live_...' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  --data '{
  "content": "I found a deal for you.",
  "type": "string",
  "media_url": "https://cdn.example.com/image.jpg",
  "offer_id": "string"
}'

Respuesta y errores

Cada respuesta incluye request_id. Las listas añaden paginación; Los recursos mutables devuelven el estado persistente después de la operación.

200 application/json
{
  "data": {
    "id": "conv_01J...",
    "channel": "instagram",
    "status": "open",
    "priority": "normal",
    "intent": "find_offer",
    "sentiment": "positive",
    "unread_count": 1
  },
  "request_id": "req_01J..."
}
200Operación completada.
400Parámetro, cuerpo o transición no válidos.
401Clave faltante, inválida, caducada o revocada.
402El plan de cuenta no libera esta interfaz.
403A chave precisa do escopo inbox:write.
404La característica no existe en esta cuenta.
409El estado actual impide esta operación.
413El cuerpo JSON supera los 128 KB.
429Se ha superado la ventana de 120 solicitudes por minuto.