Runbook — Remarketing do Sagazchat

Manual operacional para uma IA ou pessoa criar e configurar remarketing no Sagazchat sem depender de tentativa visual cega.

Status: validado em 2026-05-11 na conta de exemplo. Não deletar remarketings existentes. Recursos de laboratório criados nesta validação:

• LAB - Remarketing Flowbuilder
• id: 150
• uuid: b96abd79-cdba-4051-86ef-d49f7c7174ef
• fluxo vinculado: LAB-BLOCOS-SEM-IA-202605101624 (id: 539)

1. Onde fica

• Sidebar: Automação › Remarketing
• Lista: https://app.sagazchat.com/remarketing
• Editor de uma sequência: https://app.sagazchat.com/remarketing/uuid/<sequenceUuid>

A lista mostra:

Coluna	Significado
Nome	Nome do remarketing. Clicar no nome abre o editor.
Em progresso	Quantos contatos estão atualmente na sequência.
Fluxos	Quantidade de fluxos vinculados à sequência.
Ações	Menu de três pontos para editar nome ou excluir.

2. Criar remarketing

Fluxo pela UI:

1. Abrir Automação › Remarketing.
2. Clicar Adicionar.
3. Modal abre com título de criação.
4. Preencher o campo Nome.
5. Clicar Adicionar.
6. Depois de criado, abrir a sequência clicando no nome.

Validações observadas:

• O nome é obrigatório.
• Mínimo observado no frontend: 2 caracteres.
• Máximo observado no frontend: 32 caracteres.

API interna usada pelo frontend:

POST /sequences
Content-Type: application/json

{ "name": "Nome do remarketing" }

Listagem:

GET /sequences?pageNumber=1

Exemplo de resposta real da lista:

{
  "id": 150,
  "name": "LAB - Remarketing Flowbuilder",
  "contacts": 0,
  "flowsIds": [539],
  "companyId": 39,
  "uuid": "b96abd79-cdba-4051-86ef-d49f7c7174ef",
  "fixed": false,
  "counter": "0"
}

3. Configurar sequência de fluxos

Abrir:

https://app.sagazchat.com/remarketing/uuid/<sequenceUuid>

A tela interna tem:

• Título da sequência.
• Switch Remarketing fixado.
• Tabela com colunas Executar, Fluxo, Espera, Ações.
• Link/botão Adicionar fluxo à sequência.

3.1 Adicionar linha de fluxo

Na tela interna, clicar Adicionar fluxo à sequência.

API interna:

POST /sequence/row/<sequenceId>

O backend cria uma linha em sequenceFlows.

3.2 Selecionar fluxo

Na coluna Fluxo, usar o combobox Escolha um fluxo.

Dados carregados de:

GET /flowbuilder/all/get

Salvar seleção:

PUT /sequence/flow/<sequenceFlowId>
Content-Type: application/json

{ "flowId": 539 }

3.3 Configurar quando a linha executa

Clique no texto da coluna Executar da linha, por exemplo:

• Executar imediatamente
• Após 1 minuto
• Após 10 minutos, 07:00 - 17:00

Isso abre um popover. Ele não parece um botão tradicional, então uma IA precisa clicar no texto/área da primeira coluna da linha.

Campos do popover:

Seção	Campo	Opções
Quando iniciar o fluxo após a última ação	Radio	Imediatamente ou Atraso
Atraso	Quantidade	1 a 99
Atraso	Unidade	Minutos, Horas, Dias
Iniciar entre	Radio	A qualquer momento ou Definir hora
Definir hora	De / Até	Horários HH:mm
Em quais dias	Radio	Quaisquer dias ou Definir dias
Definir dias	Multi-select	Seg, Ter, Qua, Qui, Sex, Sab, Dom
Final	Botão	Salvar

Ao clicar Salvar, o frontend envia:

PUT /sequence/row/<sequenceFlowId>
Content-Type: application/json

{
  "id": 305,
  "sequenceId": 150,
  "flowId": 539,
  "typeStart": "Delay",
  "qtdTime": 1,
  "typeTime": "minutos",
  "dateStart": null,
  "dateEnd": null,
  "daysWeek": null,
  "position": 0,
  "counter": 0
}

Mapeamento real:

UI	Payload
Imediatamente	typeStart: "Immediately", qtdTime: null, typeTime: null
Atraso 1 minuto	typeStart: "Delay", qtdTime: 1, typeTime: "minutos"
Atraso em horas	typeTime: "horas"
Atraso em dias	typeTime: "dias"
A qualquer momento	dateStart: null, dateEnd: null
Definir hora 07:00 a 17:00	dateStart: "07:00", dateEnd: "17:00"
Quaisquer dias	daysWeek: null
Definir dias	daysWeek: ["Seg", "Ter", ...]

4. Remarketing fixado

O switch Remarketing fixado fica no topo do editor.

API interna:

PUT /sequence/fixed/<sequenceId>
Content-Type: application/json

{ "fixed": true }

Comportamento observado/descrito na UI:

• Fixado ativado: não espera o fluxo acabar para agendar o próximo.
• Fixado desativado: respeita a sequência, esperando a execução anterior antes de agendar o próximo passo.

Use desativado para jornadas dependentes entre etapas. Use ativado só quando os fluxos são independentes e podem ser agendados sem esperar término.

5. Template API Oficial

Se houver conta API Oficial WhatsApp conectada, a tela pode mostrar Template API Oficial (opcional).

Endpoints observados:

GET /waoficial
PUT /sequence/template/<sequenceId>

Payload para remover template:

{
  "templateName": null,
  "templateLanguage": null,
  "templateComponents": null
}

O template serve para reabrir conversa quando a janela de 24h estiver expirada antes de disparar o fluxo. Na conta validada, GET /waoficial retornou [], então a seleção de template não foi configurada.

6. Excluir e editar nome

Na lista /remarketing, o menu de três pontos da linha tem:

• Editar: altera só o nome via PUT /sequences.
• Excluir: remove a sequência via DELETE /sequences/<sequenceId>.

Excluir é destrutivo e não deve ser usado por IA sem ordem explícita.

7. Usar Remarketing dentro do Fluxo de Conversa

O criador de fluxo não tem bloco drag-and-drop chamado Remarketing. Ele usa o bloco Ação.

No bloco Ação, escolher:

• Inscrição em Remarketing
• Descadastrar do Remarketing

O painel carrega remarketings com:

GET /sequences

Payload salvo no node de fluxo:

{
  "type": "remarketing",
  "data": {
    "sequenceId": 150,
    "sequenceName": "LAB - Remarketing Flowbuilder",
    "subscriber": true
  }
}

Para descadastrar:

{
  "type": "remarketing",
  "data": {
    "sequenceId": 150,
    "sequenceName": "LAB - Remarketing Flowbuilder",
    "subscriber": false
  }
}

8. Checklist para outra IA

Antes de dizer que criou remarketing, confirmar:

1. A sequência existe em /remarketing.
2. O editor abre por /remarketing/uuid/<uuid>.
3. Pelo menos uma linha existe em sequenceFlows.
4. Cada linha necessária tem flowId.
5. A coluna Executar foi clicada e o popover foi salvo, quando houver atraso/horário/dias.
6. O switch Remarketing fixado está no estado desejado.
7. Se for usar no Flowbuilder, o bloco Ação aponta para sequenceId real, não nome inventado.

9. Scripts de auditoria criados

• scripts/sagaz-remarketing-inspect.mjs: inspeciona lista.
• scripts/sagaz-remarketing-detail-inspect.mjs: inspeciona editor por uuid.
• scripts/sagaz-remarketing-settings-popover.mjs: abre o popover da coluna Executar.
• scripts/sagaz-remarketing-create-lab.mjs: cria/garante o remarketing lab e vincula ao fluxo lab.