Skip to main content
POST
Retorna un resumen consolidado de un contacto a partir de su número de WhatsApp: la última actividad del chat, el nombre registrado, la cantidad de tickets y los registros vinculados (cotizaciones, ventas y órdenes de ecommerce). Útil para integraciones de CRM que necesitan conocer el historial de un número antes de iniciar una conversación o escalar un ticket.

Autenticación

Requiere el encabezado x-api-key con el App Key del negocio. Consulta Autenticación.

Encabezados

string
required
App Key del negocio. Consulta Autenticación.

Cuerpo de la solicitud

string
required
Número de WhatsApp del contacto. Se aceptan formatos con o sin caracteres especiales (guiones, espacios, +) — el sistema extrae solo los dígitos. Ejemplo: +504 9489-8989 o 50494898989.
number
ID del negocio en el que se busca el número. Se infiere automáticamente del App Key enviado en x-api-key, por lo que normalmente puede omitirse.

Comportamiento

  • La búsqueda se hace sobre el número de contacto normalizado a dígitos. Si el contacto no existe en Iobot, la respuesta es 404.
  • Si el contacto existe pero no tiene chat en el negocio consultado, la respuesta también es 404.
  • Cuando un contacto tiene más de un chat en el negocio, se toma el más reciente según ultimo_mensaje.
  • Las cotizaciones y las ventas provienen de los registros de movimientos del chat. Se devuelven tanto la cantidad de registros como la suma de sus montos.

Respuesta

boolean
true cuando la solicitud se procesó correctamente.
number
ID del chat asociado al número dentro del negocio.
string
Fecha y hora del último mensaje del chat, en formato ISO 8601.
string
Nombre del contacto registrado en Iobot. Si el contacto nunca fue nombrado, se retorna el número de teléfono.
number
Total de tickets asociados al chat.
number
Cantidad de cotizaciones registradas en el chat.
number
Suma de los montos de las cotizaciones registradas en el chat.
number
Cantidad de ventas registradas en el chat.
number
Suma de los montos de las ventas registradas en el chat.
number
Cantidad de órdenes de ecommerce vinculadas al chat.