As ações de Integração ligam o fluxo a serviços de fora da Martz:
Chamar IA envia um texto (um prompt) a um modelo de inteligência artificial e usa a resposta no fluxo.
Chamar webhook chama uma URL externa com dados do fluxo.
Para adicionar uma delas, clique no + da saída do cartão e abra a aba Integração do seletor. Se você ainda não conhece o seletor ou os Caminhos extras, veja Ações: visão geral.
Chamar IA
O que faz
Envia um prompt para um modelo de IA e usa a resposta no fluxo. No seletor, a descrição é: "Executa um prompt contra o provedor de IA configurado pela loja." A frase da folha é "Envia um prompt para um modelo e usa a resposta no fluxo."
Antes de começar: cadastre a chave do provedor
A ação usa a chave do provedor de IA da sua loja. Cadastre a chave antes, em:
Configurações › Minhas integrações › Inteligência artificial (Fluxos)
Essa seção tem um cartão para cada provedor: OpenAI, Anthropic e Google. Em cada cartão:
Cadastrar chave: aparece quando ainda não há chave cadastrada (Nenhuma chave cadastrada).
Trocar chave e Remover: aparecem quando já há uma chave. A tela mostra apenas os quatro últimos caracteres dela.
Se você escolher, na folha, um provedor que ainda não tem chave, aparece um alerta: Cadastre uma chave de (nome do provedor) para usar esta ação. A tela explica: "Sem uma chave ativa para este provedor, o fluxo não consegue chamar a IA nesta etapa." O alerta traz o botão Configurar.
Nunca cole a chave do provedor em um prompt, em um campo de mensagem ou em um chamado. Ela só deve ser cadastrada nesta seção.
Como configurar
Campo (como aparece) | Obrigatório | O que escolher / opções / limites | Para que serve |
Provedor | Sim | OpenAI, Anthropic ou Google (Selecionar provedor). Se o provedor não tiver chave cadastrada, aparece o alerta Cadastre uma chave… com o botão Configurar. | Qual empresa de IA será usada. |
Modelo | Não (opcional) | A lista depende do provedor e fica desabilitada (Selecione o provedor primeiro) até você escolher um. Ao escolher o provedor, o primeiro modelo da lista já vem selecionado. Em 09/10/2026: OpenAI com GPT-6 Astra, GPT-6 Sol e GPT-6 Luna; Anthropic com Claude Opus 5.5, Claude Fable 5.1, Claude Sonnet 5.5 e Claude Haiku 4.5; Google com Gemini 3.8 Flash e Gemini 3.5 Flash-Lite. A lista muda com o tempo: vale a que aparece na sua tela. | Qual modelo do provedor responde. |
Prompt | Sim | Texto livre, com o botão { } (Inserir variável). | A instrução enviada ao modelo. Use variáveis para incluir dados do cliente. A explicação (ⓘ) avisa: a resposta da IA pode conter qualquer texto; antes de usá-la numa mensagem ao cliente, confira com uma condição. |
Tempo limite | Não (opcional) | Lista fechada: Padrão (20 segundos), 10 segundos, 30 segundos e 60 segundos. Não dá para digitar outro valor. | Quanto tempo esperar a resposta do modelo. |
Esforço de raciocínio | Não (opcional) | Padrão do provedor, Baixo, Médio ou Alto. | Quanto a IA pensa antes de responder: mais esforço, mais custo e demora. Sem escolha, vale o padrão do provedor. Modelos sem esse ajuste ignoram o campo. |
Caminhos extras | Não | Erro na chamada e Tempo esgotado. | Saídas adicionais, para tratar cada desfecho. |
A folha dá um exemplo de variável com valor padrão, para quando o dado não existir: {{customer.first_name | default:"cliente"}}.
Saídas
Saída | Quando acontece |
Saída principal, sem nome no canvas | A IA respondeu e o fluxo segue para o próximo passo. |
Erro na chamada (extra) | O provedor recusou o prompt ou devolveu erro. |
Tempo esgotado (extra) | O modelo não respondeu dentro do tempo limite. |
Exemplo de uso
Exemplo: gatilho Mensagem recebida → Chamar IA com o prompt "Resuma em uma frase o pedido do cliente: ..." → um passo seguinte. Em Erro na chamada e Tempo esgotado, ligue os dois caminhos a Atribuir atendente, para uma pessoa assumir quando a IA falhar.
Pegadinhas e limites
Escolha o Provedor antes do Modelo.
O Prompt é obrigatório. Sem ele, a folha avisa Escreva o prompt a enviar.; sem provedor, Selecione o provedor do modelo. O cartão mostra Prompt não definido, com 2 pendências.
O Tempo limite só tem as quatro opções da lista. Se você não escolher, são 20 segundos.
Esforço de raciocínio maior significa mais custo e mais demora.
A chave do provedor é da sua loja. Ela fica em Configurações › Minhas integrações, nunca no fluxo.
A resposta de uma IA pode conter qualquer texto. Antes de mandá-la ao cliente, confira com uma condição.
Ligue Erro na chamada e Tempo esgotado se o passo for importante para o seu fluxo.
Nome técnico (para suporte): llm_call
Chamar webhook (folha "Webhook de saída")
O que faz
Chama uma URL externa com dados do fluxo. Serve para avisar um sistema seu (ERP, planilha, ferramenta de automação) de que algo aconteceu.
No seletor o nome é Chamar webhook, com a descrição "Chama uma URL externa e mapeia a resposta para variáveis." A folha que abre tem o título Webhook de saída, com a frase "Chama uma URL externa com dados do fluxo." É a mesma ação. Apesar da descrição do seletor, a folha não tem campo para mapear a resposta da URL.
Atenção: os dados que você coloca no corpo e nos cabeçalhos saem da Martz e vão para a URL que você informar. Use apenas endereços de sistemas que você controla ou em que confia, e envie só o que o outro sistema precisa.
Como configurar
Campo (como aparece) | Obrigatório | O que escolher / opções / limites | Para que serve |
Método | Sim | Três botões: POST (padrão), PUT e GET. Não há PATCH. Com GET, os campos Tipo do corpo, Corpo da requisição e Campos do formulário somem: a chamada vai sem corpo. | O método da chamada. |
URL | Sim | Texto, começando por | O endereço que será chamado. |
Cabeçalhos | Não (opcional) | Linhas com Chave (até 100 caracteres) e Valor (até 2.000 caracteres, com o botão { }). A folha começa com uma linha vazia. O botão Adicionar cabeçalho cria outra; Remover cabeçalho (com o número da linha) tira uma. | Cabeçalhos enviados na chamada. O Content-Type vem do Tipo do corpo. |
Tipo do corpo | Não (opcional) | Só com POST ou PUT. JSON (padrão), Formulário (x-www-form-urlencoded) (troca Corpo da requisição por Campos do formulário), Texto ou XML. | Define o formato do corpo e como as variáveis são escapadas. |
Corpo da requisição | Não (opcional) | Só com POST ou PUT e tipo JSON, Texto ou XML. Texto livre, com o botão { }. Em JSON, aparece também o botão Formatar. Exemplo da folha (JSON): | O conteúdo enviado. Em JSON, variáveis de texto vão entre aspas. |
Campos do formulário | Não (opcional) | Só com POST ou PUT e tipo Formulário (x-www-form-urlencoded). Linhas com Chave e Valor (com o botão { }) e o botão Adicionar campo. | Cada linha vira um campo chave=valor; a codificação é feita para você. |
Caminhos extras | Não | Erro na chamada e Tempo esgotado. | Saídas adicionais, para tratar cada desfecho. |
Saídas
Saída | Quando acontece |
Saída principal, sem nome no canvas | A chamada funcionou e o fluxo segue para o próximo passo. |
Erro na chamada (extra) | A URL respondeu com erro ou não pôde ser alcançada. |
Tempo esgotado (extra) | A URL não respondeu dentro do tempo limite. |
Exemplo de uso
Exemplo: gatilho Pedido pago → Chamar webhook com Método POST e corpo JSON com o nome do cliente e o número do pedido, para avisar o sistema de estoque da loja. Em Erro na chamada, Adicionar tag ao cliente "Falha ao avisar estoque", para a equipe acompanhar.
Pegadinhas e limites
O Content-Type é definido pelo Tipo do corpo. Não precisa colocá-lo nos cabeçalhos.
Em Tipo do corpo, o formato define como as variáveis são escapadas. Escolha o tipo que o outro sistema espera.
Só existem POST, PUT e GET. Se o outro sistema exige PATCH, a tela não oferece essa opção.
Com GET não existe corpo: para enviar dados no corpo, use POST ou PUT.
URL e Método são obrigatórios. Sem a URL, a folha avisa Informe a URL de destino. e o cartão mostra URL não definida, com 2 pendências.
A chamada leva dados do fluxo para fora da Martz. Revise o corpo e os cabeçalhos antes de ativar.
Nome técnico (para suporte): webhook_out
Próximos passos
Ações de atendimento: encaminhe ao atendimento humano quando a IA ou o webhook falhar.