1-buc-disparador-rcs-e-sms

Visão Geral

Este workflow n8n é o primeiro componente da Fase 1: Disparo da Campanha (Outbound) do sistema de Disparo de RCS com fallback de SMS via Pontal Tech. Ele é acionado por uma interface Retool e tem como responsabilidade principal realizar a integração com a Pontal Tech para o envio das mensagens.

Objetivo

O objetivo primordial deste fluxo é:

• Receber os dados de uma campanha (lista de telefones e mensagens) do aplicativo Retool.
• Realizar requisições de API para o endpoint da Pontal Tech, orquestrando o envio de mensagens RCS e aplicando o fallback para SMS quando necessário.
• Gerenciar as credenciais e configurações de integração com a plataforma de disparo.

Referências

Fluxos / Aplicações Relacionadas

• Disparador de RCS - Interface de Campanhas (Retool): Aplicativo Retool que aciona este workflow para iniciar campanhas.

Links Externos

• Workflow n8n: https://workflows.kloudbr.net/workflow/eMAdle5BUgEhwf2R

Diagrama de Fluxo

graph TD
    A[Start] --> B["Nó 1 - Nome do Gatilho (Webhook / Manual)"]
    B --> C{"Nó 2 - Lógica de Preparação de Dados"}
    C --> D["Nó 3 - Chamada de API para Pontal Tech"]
    D --> E{"Nó 4 - Tratamento de Resposta da API"}
    E --> F["Nó 5 - Registro de Sucesso/Erro (Webhook / Logs)"]
    F --> G[End]

    classDef start fill:#e1f5ff
    classDef process fill:#f0f8ff
    classDef decision fill:#ffe1e1
    class A,G start
    class B,D,F process
    class C,E decision

• Nota: O diagrama acima é um placeholder genérico. Precisamos analisar o workflow no n8n para desenhar o diagrama correto e detalhá-lo nó por nó.

Variáveis do Fluxo

Variáveis de Entrada (Input)

• Nota: Estas variáveis são recebidas do aplicativo Retool. Precisamos analisar o workflow n8n para identificar as variáveis exatas esperadas e sua estrutura.

Variáveis Internas (Flow Variables)

• Nota: Precisamos analisar o workflow n8n para identificar as variáveis internas criadas e manipuladas.

Variáveis do Usuário (User Context)

• Nota: Este fluxo pode não manipular variáveis de usuário diretamente, mas pode conter dados de usuário dentro de phone_list.

Variáveis Computadas

• Nota: Quaisquer transformações ou lógicas complexas que geram novas variáveis.

Propriedades Externas Manipuladas

Sistema: Pontal Tech

Entrada (Input)

Estrutura Esperada

• Nota: A estrutura exata do payload de entrada deve ser obtida pela configuração do Webhook (Trigger) do n8n que o Retool aciona.

{
  "records": [
    {
      "phone": "string",
      "campaign_name": "string",
      "message_content": "string",
      "client_id": "string",
      "template_params": {
        "param1": "value1",
        "param2": "value2"
      }
    }
    // ...outros registros de leads
  ],
  "global_campaign_settings": {
    "sender_id": "string",
    "fallback_enabled": true,
    "max_retries": 3
  }
}

Validações

• Nota: Quais validações de input são realizadas no workflow n8n.

Fluxo Detalhado

• Nota: Esta seção deve ser preenchida com o detalhamento nó a nó do workflow n8n, similar ao que foi feito no disparo-rcs/index.md do Hyperflow. Precisamos de acesso ao n8n para isso.

Dependências Externas

Webhooks / APIs

Pontal Tech (API de Disparo)

• Endpoint: [URL do endpoint da Pontal Tech]
• Método: [POST]
• Nó: [Nó de Chamada de API]
• Fluxo relacionado: N/A
• Headers: [Ex: Authorization: Bearer <API_KEY>]
• Body: [Estrutura do payload enviado para a Pontal Tech]
• Resposta esperada: [Estrutura da resposta da Pontal Tech]

Saída (Output)

Cenários de Finalização

• Nota: O que acontece após a execução do workflow n8n. Ele apenas faz o disparo, ou envia informações para outro sistema? De acordo com o rascunho.md, ele apenas “realiza a chamada de API”. No entanto, é comum que fluxos de disparo emitam eventos ou registrem logs.

Cenário 1: Disparo de Campanha Realizado com Sucesso

Estado final:

• Mensagens enviadas (RCS ou SMS) pela Pontal Tech.
• Potencialmente, logs ou eventos de sucesso registrados (interno do n8n ou outro sistema).

Condição de ativação: A chamada para a API da Pontal Tech retorna sucesso para os disparos.

Cenário 2: Falha no Disparo de Campanha

Estado final:

• Mensagens não enviadas ou enviadas parcialmente.
• Potencialmente, logs ou eventos de erro registrados.

Condição de ativação: A chamada para a API da Pontal Tech retorna erro ou timeout.

Eventos de Analytics

• Nota: Qualquer evento de analytics que o n8n emite após a execução (ex: campaign.message.sent).

Rótulos/Tags Aplicados

• Nota: Se o n8n aplica tags em algum sistema externo como parte do processo.

Métricas e Tempos

• Nota: Quaisquer métricas de desempenho ou tempos de espera configurados.

Notas Técnicas

• Nota: Observações sobre a lógica, configurações específicas ou dependências.

Sobre Integrações

• Pontal Tech: O fluxo é totalmente dependente da API da Pontal Tech para o envio das mensagens. Qualquer alteração ou indisponibilidade nesta API impactará diretamente a capacidade de disparo.

Troubleshooting

• Nota: Como diagnosticar problemas neste workflow.

Changelog

Referências

• Documentação da API da Pontal Tech (se disponível)

Minha sugestão agora é preencher este arquivo flows/n8n/1-buc-disparador-rcs-e-sms/index.md com o conteúdo acima.

Você aprova este conteúdo inicial para flows/n8n/1-buc-disparador-rcs-e-sms/index.md?