Obtener un contacto

GET

api

contacts

{contactId}

Get a contact

curl --request GET \
  --url https://levios.app/api/v1/contacts/{contactId} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://levios.app/api/v1/contacts/{contactId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "error": {
    "code": "api_invalid_content_length",
    "message": "Invalid Content-Length.",
    "correlation_id": "<string>"
  }
}

{
  "error": {
    "code": "api_unauthorized",
    "message": "Authentication required.",
    "correlation_id": "<string>"
  }
}

{
  "error": {
    "code": "api_account_not_granted",
    "message": "This credential is not authorized for the request.",
    "correlation_id": "<string>"
  }
}

{
  "error": {
    "code": "api_contact_not_found",
    "message": "The requested contact was not found.",
    "correlation_id": "<string>"
  }
}

{
  "error": {
    "code": "api_body_too_large",
    "message": "The JSON request body exceeds 1 MiB.",
    "correlation_id": "<string>"
  }
}

{
  "error": {
    "code": "api_unsupported_media_type",
    "message": "Content-Type must be application/json.",
    "correlation_id": "<string>"
  }
}

{
  "error": {
    "code": "api_invalid_cursor",
    "message": "The contact timeline cursor is invalid.",
    "correlation_id": "<string>"
  }
}

{
  "error": {
    "code": "rate_limited",
    "message": "Rate limit exceeded.",
    "correlation_id": "<string>"
  }
}

{
  "error": {
    "code": "api_internal_error",
    "message": "The request could not be completed.",
    "correlation_id": "<string>"
  }
}

{
  "error": {
    "code": "api_account_resolution_unavailable",
    "message": "The reachable account set could not be read.",
    "correlation_id": "<string>"
  }
}

Este endpoint devuelve el registro completo de un contacto y una página de su cronología de actividad. Usa el UUID de contacto que devuelve Listar contactos como contactId.

Acceso

Tu clave de API necesita el permiso contacts:read_pii. El parámetro de consulta account_id debe identificar una cuenta de Instagram a la que pueda acceder la clave, y contactId debe pertenecer a esa cuenta. Este endpoint incluye información de identificación personal (PII) y está auditado. Si la API no puede registrar la entrada de auditoría obligatoria, falla sin devolver el contacto.

Datos devueltos

El objeto contact contiene todos los campos que devuelve la lista de contactos, incluidos email, phone, biography, website, tags, attributes, instagram_profile_url y send_instagram_dm_url. También contiene un objeto timeline. Consulta Listar contactos para ver todos los grupos de campos y el significado de los enums. El array timeline.items puede contener estos tipos de eventos:

first_contact: levios registró la primera actividad del contacto.
dm_sent: se envió un mensaje directo.
dm_failed: se produjo un error al enviar un mensaje directo.
tag_applied: se añadió una etiqueta al contacto.
attribute_captured: se capturó un atributo del contacto.

Cada elemento de la cronología incluye id, type y timestamp.

Solicitud de ejemplo

curl --get \
  --url "https://levios.app/api/v1/contacts/${LEVIOS_CONTACT_ID}" \
  --header "Authorization: Bearer ${LEVIOS_API_KEY}" \
  --data-urlencode "account_id=${LEVIOS_ACCOUNT_ID}" \
  --data-urlencode 'timeline_limit=25'

Paginación de la cronología

Configura timeline_limit con un valor entre 1 y 50. Cuando contact.timeline.next_cursor no sea null, envíalo sin cambios como timeline_cursor con los mismos account_id y contactId. Detente cuando el cursor sea null. Trata los cursores de la cronología como valores opacos. No reutilices un cursor para otro contacto o cuenta. Como esta respuesta incluye datos personales, evita escribir la carga completa en registros, eventos de analítica o informes de errores.

Autorizaciones

Authorization

string

header

requerido

Levios API key sent as a Bearer token.

Parámetros de ruta

contactId

string<uuid>

requerido

Parámetros de consulta

account_id

string<uuid>

requerido

timeline_cursor

string

Required string length: 1 - 2048

timeline_limit

string

Respuesta

Successful response.

Get a contact

curl --request GET \
  --url https://levios.app/api/v1/contacts/{contactId} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://levios.app/api/v1/contacts/{contactId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "error": {
    "code": "api_invalid_content_length",
    "message": "Invalid Content-Length.",
    "correlation_id": "<string>"
  }
}

{
  "error": {
    "code": "api_unauthorized",
    "message": "Authentication required.",
    "correlation_id": "<string>"
  }
}

{
  "error": {
    "code": "api_account_not_granted",
    "message": "This credential is not authorized for the request.",
    "correlation_id": "<string>"
  }
}

{
  "error": {
    "code": "api_contact_not_found",
    "message": "The requested contact was not found.",
    "correlation_id": "<string>"
  }
}

{
  "error": {
    "code": "api_body_too_large",
    "message": "The JSON request body exceeds 1 MiB.",
    "correlation_id": "<string>"
  }
}

{
  "error": {
    "code": "api_unsupported_media_type",
    "message": "Content-Type must be application/json.",
    "correlation_id": "<string>"
  }
}

{
  "error": {
    "code": "api_invalid_cursor",
    "message": "The contact timeline cursor is invalid.",
    "correlation_id": "<string>"
  }
}

{
  "error": {
    "code": "rate_limited",
    "message": "Rate limit exceeded.",
    "correlation_id": "<string>"
  }
}

{
  "error": {
    "code": "api_internal_error",
    "message": "The request could not be completed.",
    "correlation_id": "<string>"
  }
}

{
  "error": {
    "code": "api_account_resolution_unavailable",
    "message": "The reachable account set could not be read.",
    "correlation_id": "<string>"
  }
}

Referencia

Automatizaciones

Cuentas

Contactos

Etiquetas de contacto

Métricas

Obtener un contacto

Acceso

Datos devueltos

Solicitud de ejemplo

Paginación de la cronología

Autorizaciones

Parámetros de ruta

Parámetros de consulta

Respuesta

​Acceso

​Datos devueltos

​Solicitud de ejemplo

​Paginación de la cronología

Autorizaciones

Parámetros de ruta

Parámetros de consulta

Respuesta

Acceso

Datos devueltos

Solicitud de ejemplo

Paginación de la cronología