Limbik

A Limbik é sua camada de ressonância de IA — prevendo como públicos reais interpretam e respondem a mensagens, conceitos e saídas de IA antes que cheguem ao mercado. Alimentada por pesquisas primárias contínuas em mais de 60 países e mais de 25 idiomas, a Limbik oferece públicos sintéticos validados por humanos — populações digitais que simulam a resposta real do público na velocidade de máquina e com precisão de nível de pesquisa (intervalo de confiança de 95%, margem de erro de 1,5% a 3%). A Limbik oferece a capacidade de garantir imediatamente que suas mensagens ressoem com o que seu público-alvo acredita e sente.

Essa integração é mantida pela Limbik.

Pré-requisitos

Os itens a seguir são necessários para usar a Limbik com a Braze:

Antes de usar qualquer um dos endpoints de previsão, você deve primeiro identificar a qual organização (account_id) você tem acesso. Embora a maioria dos clientes tenha apenas uma organização, algumas contas podem ter várias organizações disponíveis.

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"
    }
  ]
}

Autenticação

Para acessar os endpoints da API, você precisa de um token bearer para autenticação. Obtenha seu token autenticando-se com suas credenciais.

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 - Geração de texto de mensagem

Usando os endpoints da REST API da Braze e da Limbik, você pode usar as previsões generativas da Limbik para criar textos de mensagem e enviá-los pelos canais de envio de mensagens da Braze, ou ajustar textos existentes para melhorar o impacto no seu público. Ambas as plataformas expõem funcionalidades que você pode chamar programaticamente para construir fluxos de trabalho sofisticados.

Esta documentação descreve dois exemplos: gerar texto de mensagem na Limbik e usar esse texto em uma mensagem subsequente enviada pela Braze, bem como usar a Limbik para avaliar a qualidade de uma determinada mensagem para o público escolhido.

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 resposta

A resposta contém os seguintes campos principais:

• type: O tipo de mensagem (por exemplo, "Generate" para conteúdo gerado por IA, "Message" para mensagens validadas)
• displayText: Um título curto ou resumo da mensagem
• additionalDetail: O texto completo da mensagem gerada por IA — Este é o campo principal que contém o texto completo da mensagem que você pode enviar pela sua plataforma de envio de mensagens
• population: O público-alvo e os segmentos para esta mensagem

Uso com a Braze

O campo additionalDetail da resposta da Limbik contém o texto da mensagem que você envia à Braze. Um padrão de integração comum é passar esse valor em trigger_properties.payload ao chamar o endpoint de envio por gatilho da Braze. No exemplo a seguir, substitua pela string real do campo `additionalDetail` da Limbik e substitua pelo ID da sua campaign.

Exemplo de solicitação de mensagem por gatilho da Braze

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

Caso de uso - Detalhes do público sintético

Para expandir o primeiro caso de uso, utilize o endpoint da Limbik /rest/api/populations/{account_id}/{population_id}.

Esse endpoint retorna pontos de dados importantes que descrevem a composição dos públicos sintéticos da Limbik, como gênero, local e assim por diante. Você pode usar esses valores para preencher objetos de Connected Audience ao chamar os endpoints de envio de mensagens da Braze.

Para obter pontuações de previsão para segmentos específicos, identifique os países disponíveis e seus segmentos correspondentes.

Etapa 1: Listar países disponíveis

Recupere a lista de países disponíveis para sua conta:

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

Na resposta, identifique o país que deseja usar. Por exemplo, os Estados Unidos têm um id de 56.

Etapa 2: Recuperar segmentos disponíveis

Após recuperar o ID do país, recupere a lista completa de segmentos para esse 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 - Avaliação da pontuação de previsão

Você pode usar a Limbik para criar uma pontuação estimada para uma mensagem em relação a um público sintético. Faça isso programaticamente com o endpoint forecasts/synchronous da Limbik.

Opção 1 - Previsão síncrona

Você pode usar a carga útil de resposta da geração de modelo diretamente com o endpoint de previsão síncrona:

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"
  }
}

Opção 2: Preparar carga útil de previsão com segmentos

Crie sua carga útil de previsão usando os segmentos selecionados. Os segmentos usam um formato simplificado de chave composta.

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"
    ]
  }
}