Limbik

Limbik es tu capa de resonancia de IA: predice cómo las audiencias reales interpretan y responden a mensajes, conceptos y resultados de IA antes de que lleguen al mercado. Impulsado por investigación primaria continua en más de 60 países y más de 25 idiomas, Limbik ofrece audiencias sintéticas validadas por humanos: poblaciones digitales que simulan la respuesta real de la audiencia a velocidad de máquina y con precisión de grado de investigación (95 % de confianza, margen de error del 1,5 % al 3 %). Limbik te da la capacidad de asegurar de inmediato que tu mensajería resuene con lo que tu audiencia objetivo cree y siente.

Esta integración es mantenida por Limbik.

Requisitos previos

Se requiere lo siguiente para usar Limbik con Braze:

Antes de usar cualquiera de los puntos de conexión de pronóstico, primero debes identificar a qué organización (account_id) tienes acceso. Aunque la mayoría de los clientes tienen solo una organización, algunas cuentas pueden tener múltiples organizaciones disponibles.

1
2
3
curl -X 'GET' \
  'https://cortex.prod.limbik.com/rest/api/organizations' \
  -H 'accept: application/json'

1
2
3
4
5
6
7
8
{
  "data": [
    {
      "uid": "aca61bd5-7132-499c-946e-42d092cc1156",
      "name": "Braze API"
    }
  ]
}

Autenticación

Para acceder a los puntos de conexión de la API, necesitas un token bearer para la autenticación. Obtén tu token autenticándote con tus credenciales.

1
2
3
4
5
6
7
8
curl -X 'POST' \
  'https://cortex.prod.limbik.com/rest/api/auth/login' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "username": "your_username",
  "password": "your_password"
}'

1
2
3
4
{
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "token_type": "Bearer"
}

1
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

Caso de uso: generar texto de mensaje

Al usar los puntos de conexión de REST API de Braze y Limbik, puedes utilizar los pronósticos generativos de Limbik para crear texto de mensaje y enviarlo a través de los canales de mensajería de Braze, o ajustar el texto existente para mejorar el impacto en tu audiencia. Ambas plataformas exponen funcionalidades que puedes llamar programáticamente para construir flujos de trabajo sofisticados.

Esta documentación describe dos ejemplos: generar texto de mensaje en Limbik y usar este texto en un mensaje posterior enviado a través de Braze, así como usar Limbik para evaluar la calidad de un mensaje dado para tu audiencia elegida.

1
2
3
4
5
curl -X 'GET' \
  'https://cortex.prod.limbik.com/rest/api/forecasts/generate/template?prompt=YOUR_PROMPT' \
  -H 'account_id: YOUR_ACCOUNT_ID' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'accept: application/json'

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
[
  {
    "type": "Message",
    "displayText": "Formula one next race",
    "additionalDetail": "The latest dev in Formula...",
    "messages": [
      {
        "body": "The latest dev in Formula ..."
      }
    ],
    "population": {
      "id": 56,
      "name": "us2",
      "org_enabled": true,
      "org_visible": true,
      "categories": [],
      "display_name": "US Adults",
      "composite_key": "us2",
      "enabled": true
    }
  }
]

Campos de respuesta

La respuesta contiene los siguientes campos clave:

• type: El tipo de mensaje (por ejemplo, "Generate" para contenido generado por IA, "Message" para mensajes validados)
• displayText: Un título corto o resumen del mensaje
• additionalDetail: El texto de mensaje completo generado por IA - Este es el campo principal que contiene el texto completo del mensaje que puedes enviar a través de tu plataforma de mensajería
• population: La población objetivo y los segmentos para este mensaje

Uso con Braze

El campo additionalDetail de la respuesta de Limbik contiene el texto de mensaje que envías a Braze. Un patrón de integración común es pasar ese valor en trigger_properties.payload al llamar al punto de conexión de envío por trigger de Braze. En el siguiente ejemplo, reemplaza con la cadena real del campo `additionalDetail` de Limbik, y reemplaza con tu ID de Campaign.

Ejemplo de solicitud de mensaje por trigger de Braze

1
2
3
4
5
6
7
{
  "campaign_id": "",
  "trigger_properties": {
    "payload": ""
  },
  "broadcast": true
}

Caso de uso: detalles de audiencia sintética

Para ampliar el primer caso de uso, utiliza el punto de conexión de Limbik /rest/api/populations/{account_id}/{population_id}.

Este punto de conexión devuelve puntos de datos clave que describen la composición de las audiencias sintéticas de Limbik, como género, ubicación, etc. Puedes usar estos valores para completar objetos de Connected Audience al llamar a los puntos de conexión de mensajería de Braze.

Para obtener puntuaciones de pronóstico para segmentos específicos, identifica los países disponibles y sus segmentos correspondientes.

Paso 1: Listar países disponibles

Recupera la lista de países disponibles para tu cuenta:

1
2
3
curl -X 'GET' \
  'https://cortex.prod.limbik.com/rest/api/populations/list/aca61bd5-7132-499c-946e-42d092cc1156' \
  -H 'accept: application/json'

De la respuesta, identifica el país que deseas usar. Por ejemplo, Estados Unidos tiene un id de 56.

Paso 2: Recuperar segmentos disponibles

Después de recuperar el ID del país, recupera la lista completa de segmentos para ese país.

1
2
3
curl -X 'GET' \
  'https://cortex.prod.limbik.com/rest/api/populations/aca61bd5-7132-499c-946e-42d092cc1156/56' \
  -H 'accept: application/json'

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
[
  {
    "id": 56,
    "name": "us2",
    "composite_key": "us2",
    "categories": [
      {
        "id": 9331,
        "name": "gender",
        "composite_key": "us2::gender",
        "segments": [
          {
            "id": 63793,
            "name": "female",
            "composite_key": "us2::gender::female"
          }
        ]
      }
    ]
  }
]

1
2
3
4
5
6
7
8
9
10
11
{
  "AND": [
    {
      "custom_attribute": {
        "custom_attribute_name": "education_level",
        "comparison": "equals",
        "value": "masters"
      }
    }
  ]
}

Caso de uso: evaluar puntuación de pronóstico

Puedes usar Limbik para crear una puntuación estimada de un mensaje contra una audiencia sintética. Hazlo programáticamente con el punto de conexión forecasts/synchronous de Limbik.

Opción 1: Pronóstico sincrónico

Puedes usar la carga útil de respuesta de la generación de plantilla directamente con el punto de conexión de pronóstico sincrónico:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
curl -X 'POST' \
  'https://cortex.prod.limbik.com/rest/api/forecasts/synchronous' \
  -H 'accept: application/json' \
  -H 'account_id: aca61bd5-7132-499c-946e-42d092cc1156' \
  -H 'Content-Type: application/json' \
  -d '{
  "type": "Generate",
  "displayText": "Formula one season testing 2026",
  "additionalDetail": "Day 1 of the 2026 Formula 1 Bahrain testing session has concluded. Lando Norris recorded the fastest time in the McLaren, with Ferrari in second place. Cadillac drivers Sergio Perez and Valtteri Bottas completed 107 laps, nearly two race distances, and Audi introduced significant upgrades. Which team do you expect to perform best in Australia? #F12026 #BahrainTesting #LandoNorris",
  "population": {
    "population": "us2",
    "segments": []
  }
}'

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
{
  "uid": "6c5e28ef-8796-4659-a743-d842a06c9bf7",
  "datetime": "2026-02-11T20:04:06.545+00:00",
  "userId": "9cdd921c-f62f-46a6-902f-a6b0d1702f99",
  "accountId": "aca61bd5-7132-499c-946e-42d092cc1156",
  "name": "Formula one season t...",
  "user_message_context": "",
  "population": [
    {
      "name": "us2",
      "display_name": "US Adults",
      "categories": []
    }
  ],
  "privacy_compliant": false,
  "model_outputs": {
    "belmetrics": {
      "metrics": {
        "moe": 0.02144,
        "pfi": "0.3611",
        "min_val": 0.2941,
        "mean_val": 0.41831
      }
    },
    "virmetrics": {
      "metrics": {
        "moe": 0.02381,
        "pfi": "0.3611",
        "min_val": 0.2,
        "mean_val": 0.30395
      }
    },
    "model_variant": "v4_0_0"
  }
}

Opción 2: Preparar carga útil de pronóstico con segmentos

Crea tu carga útil de pronóstico usando los segmentos seleccionados. Los segmentos usan un formato de clave compuesta simplificado.

1
2
3
4
5
6
7
8
9
10
11
{
  "type": "Generate",
  "displayText": "Formula one season testing 2026",
  "additionalDetail": "🚀 Day 1 of 2026 F1 Bahrain testing just dropped BOMBS! Lando Norris edged out Max Verstappen for P1 in McLaren's beast, with Ferrari hot on their heels 🔥. But the real shocker? Cadillac's debutants Sergio Perez & Valtteri Bottas smashed 107 laps – nearly TWO race distances! New kids on the block are HERE to stay. Audi's radical upgrades already turning heads too. Who's your early fave for Australia? 👀 #F12026 #BahrainTesting #LandoNorris",
  "population": {
    "population": "us2",
    "segments": [
      "gender::female"
    ]
  }
}