Nó: Programar mensagem

O nó Programar mensagem enfileira uma mensagem de saída para o contato que será enviada em um momento futuro, em vez de ser enviada imediatamente. É a forma de montar lembretes, acompanhamentos ou mensagens adiadas dentro de um workflow.

Quando usar

• Para lembretes ("escrevo de novo amanhã se você não responder"), acompanhamentos pós-venda ou mensagens de reativação programadas com antecedência.
• Quando o envio não deve sair no momento do gatilho, e sim mais adiante.

Requisitos

• A mensagem (content) não pode estar vazia.
• É preciso ser possível resolver uma conversa de destino conforme o modo de canal escolhido (veja abaixo).
• As variáveis da mensagem ({{contact.first_name}} etc.) são resolvidas no momento de programar, não quando a mensagem é efetivamente enviada — ou seja, refletem o estado do contato naquele momento, não o que ele tiver horas ou dias depois.

Configuração

• Momento de envio:
  • Modo relativo (mode = relative): envia N minutos após ser programado (delay_minutes).
  • Modo absoluto (mode = absolute): envia em uma data/horário exato (at). Se essa data já tiver passado no momento em que o nó rodar, a mensagem é enviada imediatamente em vez de ser perdida.
• Modo de canal (channel_mode):
  • last (padrão): na mesma conversa do gatilho.
  • specific: em uma conversa existente (ou nova) do canal escolhido.
  • start_new: sempre cria uma conversa nova no canal escolhido — pensado justamente para envios programados em que pode não haver uma conversa aberta naquele momento.
• Canal (channel_id): obrigatório se o modo for specific ou start_new.
• Mensagem (content, obrigatório): o texto a enviar; aceita variáveis.

Exemplo de uso

Um workflow é disparado quando um agente encerra uma conversa de venda sem o contato confirmar o pagamento. O nó Programar mensagem é configurado em modo relativo com delay_minutes = 1440 (24 horas) e channel_mode = start_new no canal de WhatsApp do contato, com o texto "Olá {{contact.first_name}}, você conseguiu concluir o pagamento? Qualquer dúvida, me avise."

Dicas

• Use start_new quando não puder garantir que existirá uma conversa aberta no momento real do envio (por exemplo, programações de vários dias).
• Se você programar em modo absoluto com uma data já passada, o sistema não descarta a mensagem: envia na hora em vez de perdê-la silenciosamente.

Solução de problemas

• "Empty message content": o campo Mensagem ficou vazio.
• "Invalid schedule time": falta delay_minutes (modo relativo) ou at (modo absoluto), ou o valor não é válido.
• "channel_mode=last but the trigger did not provide an open conversation": mude para specific ou start_new e indique um canal, já que o modo last precisa de uma conversa ativa no gatilho.