Ricky logorickyDocs

Listar las conversaciones que trajeron los anuncios

GET
/ads/conversations

Cada conversación que un anuncio de Meta abrió o trajo de vuelta en el período, de la más reciente a la más antigua, con el anuncio, el contacto, el estado de la conversación y las respuestas que recibió. Se lee de los mensajes de clientes que recibió Ricky, así que funciona sin conectar Meta Ads; el nombre, la campaña y el conjunto del anuncio (ad_referral.resolved) necesitan la conexión. El período son días de America/Panama, como en GET /reports/ads, y estas filas suman las conversaciones por anuncio de ese reporte.

Permiso: conversations:read.

Autorización

bearerAuth
headerAuthorizationBearer <clave>

Una clave de API de la organización, rky_live_…, creada en Configuración → API. Envíala solo desde un servidor.

Parámetros de consulta

from?string

Primer día, YYYY-MM-DD, America/Panama, incluido. Envíalo junto con to; sin ninguno de los dos, el reporte cubre los últimos 7 días, hoy incluido.

Patrón^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$
Formatodate
to?string

Último día, YYYY-MM-DD, America/Panama, incluido. Un día posterior a hoy cuenta como hoy. El período tiene como máximo 366 días.

Patrón^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$
Formatodate
ad_id?string

Solo este anuncio de Meta.

Patrón^\d+$
Longitudlength <= 32
campaign_id?string

Solo los anuncios de esta campaña de Meta, entre los que Ricky sincronizó de una cuenta publicitaria conectada.

Patrón^\d+$
Longitudlength <= 32
ad_set_id?string

Solo los anuncios de este conjunto de Meta, entre los que Ricky sincronizó de una cuenta publicitaria conectada.

Patrón^\d+$
Longitudlength <= 32
channel?string

Solo las conversaciones de este canal.

Uno de"whatsapp""instagram""messenger"
page_size?integer

Elementos por página.

Rango1 <= value <= 100
Predeterminado50
cursor?string

next_cursor de la página anterior. Úsalo sin cambios.

Longitudlength <= 2048

Cuerpo de la respuesta

Éxito.

application/json
  1. response
data*array<>
next_cursor*|

Pásalo como cursor para la página siguiente; null en la última página.

curl -X GET 'https://getricky.ai/api/v1/ads/conversations'
{  "data": [    {      "ad_referral": {        "ad_id": "120210000000000001",        "channel": "whatsapp",        "message_id": "c41d7e2a-5b6f-4a89-8c3d-0e1f2a3b4c5d",        "conversation_id": "9b2e4c61-7a3f-4d18-b5c2-6e0f1a2b3c4d",        "contact_id": "3f6c2b1e-8d4a-4b7e-9a51-2c7d8e9f0a1b",        "referred_at": "2026-10-14T15:30:00.000Z",        "source_type": "ad",        "source_url": "https://fb.me/2ZBx1WlQe",        "headline": "Implantes dentales en un día",        "body": "Agenda tu evaluación sin costo.",        "media_type": "video",        "image_url": null,        "video_url": null,        "ctwa_clid": "ARAkLkA8rmlFeiCktEJQ-QTwRiyYHAFDLMNDBH0CD3qpjd0HR4irJ6LEkR7JwFF4XvnO2E4Nx0-eM-GABDLOPaOdRMv-_zfUQ2a",        "ref": null,        "resolved": {          "ad_name": "Implantes - video octubre",          "campaign_id": "120210000000000003",          "campaign_name": "Implantes dentales",          "ad_set_id": "120210000000000002",          "ad_set_name": "Panamá 30-55",          "ad_account_id": "1234567890",          "synced_at": "2026-10-14T15:30:00.000Z"        }      },      "opened_conversation": true,      "message_text": "Hola, quiero más información sobre los implantes.",      "contact": {        "id": "3f6c2b1e-8d4a-4b7e-9a51-2c7d8e9f0a1b",        "name": "Ana Pérez",        "phone": "+50760001234",        "external_id": "50760001234"      },      "conversation": {        "id": "9b2e4c61-7a3f-4d18-b5c2-6e0f1a2b3c4d",        "status": "open",        "close_category": "resolved",        "closed_at": "2026-10-14T15:30:00.000Z",        "created_at": "2026-10-14T15:30:00.000Z"      },      "customer_messages": 0,      "replies": 0,      "first_reply_seconds": 0    }  ],  "next_cursor": "string"}

Consultar los resultados de los anuncios de Meta GET

El gasto, la entrega y las acciones que cuenta Meta para las cuentas publicitarias conectadas en un período, por cuenta, campaña, conjunto o anuncio, calculados en vivo por Meta. Responde `rule_violation` cuando la organización no conectó Meta Ads, y `forbidden` cuando Meta ya no acepta su conexión. Permiso: `reports:read`.

Consultar resultados de campañas de Google Ads GET

Métricas en vivo de campañas de Google Ads y conversaciones de WhatsApp atribuidas a las cuentas publicitarias seleccionadas por la organización. Permiso: `reports:read`.