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

Listar notas de contacto

Enumera notas internas con autor y fecha.

GET/inbox/contacts/{id}/notesinbox:read
COMPORTAMIENTO

La lectura busca el identificador dentro de la cuenta vinculada a la clave y devuelve 404 cuando no pertenece a la operación.

EFECTO

No cambia los recursos ni activa la publicación.

REPETICIÓN

Es seguro repetir la operación. En 429 o 5xx, use retroceso exponencial con fluctuación.

Solicitar

idstring · pathIdentificador de recursos.minLength 2 · maxLength 100obligatorio
limitinteger · queryCantidad por página.min 1 · max 100 · default 30opcional
offsetinteger · queryDesplazamiento de paginación.min 0 · default 0opcional
AuthorizationBearer ach_live_...
Acceptapplication/json
Alcanceinbox:read

Ejemplo ejecutable

curl
curl 'https://achadu.com/api/v1/inbox/contacts/resource_id/notes' \
  -H 'Authorization: Bearer ach_live_...' \
  -H 'Accept: application/json'

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
    }
  ],
  "pagination": {
    "total": 1,
    "limit": 30,
    "offset": 0,
    "has_more": false
  },
  "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:read.
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.