OpenAI: gerar texto

Use o OpenAI: gerar texto para solicitar a um modelo OpenAI um pequeno trecho de texto no meio da jornada e, em seguida, reutilizá-lo em um push, e-mail ou SMS posterior. Este ponto se autentica com sua própria chave de API da OpenAI. Ele não usa nenhuma integração em nível de conta configurada em outro lugar nas Configurações.

Usos típicos:

• Personalize uma linha de mensagem: elabore um gancho de uma linha a partir das tags de um viajante e, em seguida, insira-o no próximo push ou e-mail com Dynamic Content.
• Resuma antes de enviar: transforme algumas tags, como último pedido ou categoria de navegação, em uma linha curta em linguagem natural que um modelo possa exibir.
• Varie a formulação: peça uma frase ligeiramente diferente em cada execução para que os viajantes não vejam o texto idêntico toda vez que passarem.

Configure o ponto

1. Arraste OpenAI: gerar texto da seção Integrações do painel esquerdo para a tela.
2. Clique duas vezes no ponto e insira um Nome da Etapa.
3. Em Chave de API da OpenAI, insira sua chave de API da OpenAI. Ela é armazenada mascarada, como um cabeçalho secreto de webhook.

4. Em Modelo, escolha o modelo OpenAI a ser usado. O padrão é gpt-5-mini.

   • gpt-5-nano e gpt-5-mini: ambos respondem bem dentro do tempo limite de 10 segundos do ponto.
   • gpt-5: pode chegar perto do tempo limite em um prompt longo. Custa mais por token do que os modelos menores.

   Cada chamada cobra sua própria chave OpenAI para cada viajante que chega a esta etapa.

5. Em Prompt, escreva o que você quer que o modelo gere. Ele aceita as mesmas macros que qualquer corpo de Webhook, por exemplo, {{device:hwid}}.

6. Clique em Salvar.

O raciocínio é definido como mínimo e as respostas são limitadas a cerca de 300 tokens (aproximadamente um parágrafo curto) para manter a solicitação dentro do tempo limite do Webhook. Peça por algo curto. Um prompt mais longo ou mais detalhado não terá mais espaço para responder.

Resposta

O viajante continua para qualquer etapa que você conectar a seguir na tela.

Atributos após a execução da etapa

Atributo	O que contém
llm_text	O texto gerado
llm_input_tokens	Contagem de tokens para a entrada da solicitação
llm_output_tokens	Contagem de tokens para a saída da solicitação

Como usar llm_text em etapas posteriores

• Insira-o em um push, e-mail ou SMS: use Dynamic Content.
• Ramifique com base nele com Condition split: salve-o primeiro em uma Tag com Update user profile e, em seguida, divida com base nessa Tag.

Falhas e respostas inesperadas

Uma solicitação com falha remove o viajante da jornada. Consulte Erros e solicitações com falha.

Uma resposta que retorna, mas não é o que você esperava, mantém o viajante na jornada:

• Texto cortado no limite de 300 tokens: llm_text contém o texto truncado.
• Modelo se recusou a responder: llm_text contém o que quer que ele tenha respondido.

Cenário de exemplo: Elaborando uma linha de e-mail de abandono de navegação com OpenAI

Uma equipe deseja que um e-mail de abandono de navegação comece com uma linha sobre o produto específico que um visitante visualizou, em vez de um assunto genérico de “volte”.

1. Adicione um elemento Trigger-based entry e configure-o para disparar em um evento ProductViewedNoPurchase.
2. Adicione OpenAI: gerar texto logo após. Em Prompt, escreva Escreva uma frase curta recomendando {{tag:Last Viewed Product}} para um comprador que o visualizou, mas não comprou.
3. Adicione uma etapa Send Email logo após, usando Dynamic Content para inserir llm_text no corpo do e-mail.

Depois que isso for executado, cada visitante receberá uma linha de abertura de e-mail sobre o produto exato que visualizou, em vez de uma linha genérica para todo o segmento.