Sequências de integração

As sequências de integração são fluxos de mensagens automáticos e de várias etapas que rodam quando um novo host entra — para que toda contratação receba uma recepção consistente.

Definir uma sequência #

Uma sequência é uma lista ordenada de etapas. Cada etapa tem:

• um canal (WhatsApp e/ou e-mail),
• um atraso em horas após a etapa anterior,
• uma referência a um modelo de mensagem reutilizável.

Se a sua agência ainda não tem nenhum canal de mensagens conectado, o editor de sequências diz isso na lata — uma sequência sem nada por onde enviar vai registrar todas as etapas como ignoradas. Conecte o WhatsApp em Configurações → Canais ou o e-mail em Configurações da agência primeiro.

Como ela dispara #

Quando uma inscrição é aceita e cria um contato novo, a sequência ativa é disparada automaticamente (com subagências, a descrita abaixo). As etapas são enviadas em ordem, espaçadas pelos seus atrasos.

Subagências #

Se a sua agência tem subagências, uma sequência pode pertencer a uma delas. Toda a agência e cada subagência podem ter uma sequência ativa por vez: ativar uma sequência desativa apenas a outra sequência ativa da mesma subagência, ou de toda a agência.

Um host novo que chega por uma inscrição recebe a sequência ativa da subagência em que está a nova conta de plataforma dele, ou a de toda a agência quando ela não está em nenhuma. Uma subagência sem sequência ativa não integra ninguém: os hosts novos dela não recebem a sequência de toda a agência no lugar. As sequências criadas antes disso pertencem a toda a agência, então, numa agência com subagências, um host novo cuja conta de plataforma está numa subagência não é integrado até que essa subagência tenha uma sequência ativa própria.

Iniciar integração num host oferece a sequência ativa de cada subagência em que estão as contas de plataforma dele, e a de toda a agência quando uma das contas dele não está em nenhuma subagência ou ele ainda não tem nenhuma. Quando há mais de uma, pergunta qual enviar. Quem está atribuído a uma subagência recebe a oferta apenas da sua própria subagência.

Ao escolher o modelo de mensagem de uma etapa, a sequência de uma subagência oferece apenas os modelos dessa subagência, não os de toda a agência, nem mesmo a quem trabalha em toda a agência; uma subagência que queira um cria o seu. Uma etapa de WhatsApp sai pelo número que corresponde à conta de plataforma para a qual a integração foi iniciada, como o de uma campanha (veja WhatsApp).

Em Sequências de integração, quem está atribuído a uma subagência vê e gerencia apenas as sequências da própria subagência; as de toda a agência aparecem apenas para quem trabalha na agência inteira. Na página de um host, qualquer pessoa que possa abrir o host vê o nome da sequência que o integrou, seja de quem for. O filtro Precisa de atenção da lista de hosts, e o número ao lado de Hosts no menu, incluem um host que não foi integrado apenas quando a subagência em que está a conta de plataforma dele, ou toda a agência para uma conta que não está em nenhuma, tem uma sequência ativa.

Uma conta de plataforma numa subagência excluída conta como em nenhuma, e a sequência de uma subagência excluída não integra ninguém.

Os hosts que já estão no meio de uma sequência recebem o restante das etapas como foram agendadas quando ela começou, e uma etapa de WhatsApp agendada antes desta mudança sai pelo número que teria usado antes.

Histórico de execuções #

Abra uma sequência e você tem uma aba Histórico de execuções. Cada disparo é registrado: quando rodou, o que o disparou, quantas etapas foram avaliadas e quantas foram concluídas, ignoradas ou falharam. A coluna na lista de sequências mostra a última execução de relance.

Uma etapa esperando a hora de ser enviada aparece Na fila, e depois o que aconteceu quando a hora chegou: Feito, Ignorado com o motivo, ou Falhou. Num e-mail, Feito quer dizer que foi enviado; um retido pelos limites de envio da agência continua Na fila até a retenção acabar, e depois aparece Feito se saiu ou Falhou se não saiu. No WhatsApp, Feito quer dizer que o WhatsApp o aceitou; o status da própria mensagem mostra se foi entregue. A integração de um host aparece Concluída na página dele quando todas as etapas seguiram seu curso. Uma etapa que falhou não impede isso: ela aparece como Falhou aqui, na execução, que é onde olhar quando um host diz que uma mensagem nunca chegou.

Abra uma execução e você vê passo a passo — qual etapa, o que aconteceu e por quê, em palavras claras. Uma etapa que não pôde enviar é registrada como Ignorado com o motivo, em vez de sumir:

Motivo	Significado
Nenhum canal de mensagens conectado	A agência não tem nem WhatsApp nem e-mail configurado.
A etapa não tem modelo de mensagem	A etapa aponta para nada a enviar.
O host não tem e-mail	Uma etapa de e-mail para um host de quem você não tem endereço.
O host não tem telefone	Uma etapa de WhatsApp para um host de quem você não tem número.
A integração foi interrompida antes de esta etapa ser enviada	A aceitação do host foi desfeita antes de a etapa vencer.
O host foi arquivado ou excluído, ou o registro dele nesta plataforma foi excluído, antes de esta etapa ser enviada	Nenhuma etapa vai para um host arquivado ou excluído, e nenhuma etapa de WhatsApp vai para um registro de plataforma excluído.
As mensagens para os hosts estavam pausadas quando esta etapa venceu	A assinatura da agência não estava ativa quando a etapa venceu.
Não era possível enviar mensagens ao host quando esta etapa venceu	O host tinha pedido para não receber mensagens, ou o número dele estava bloqueado ou não era válido.
Não foi possível iniciar a integração, então esta etapa nunca entrou na fila	Algo deu errado enquanto a integração era iniciada. A etapa aparece como Falhou e nunca foi enviada.
Um valor do modelo está vazio para este host	Uma etapa cujo modelo usa um valor que este host não tinha quando a integração começou, quando a mensagem de cada etapa é preparada. Nada é enviado em vez de uma mensagem com uma lacuna.

É esse o ponto do registro: "o host nunca recebeu a mensagem de boas-vindas" agora tem resposta na tela, em vez de exigir um ticket de suporte.

Uma coisa que vale saber sobre como ler os números:

• É registrada uma execução por host sendo integrado, e as contagens dela são dos etapas daquele host — não uma contagem de hosts. Uma sequência que recebeu dez contratações tem dez execuções.

As execuções são mantidas por cerca de 90 dias.

Pulo de canal #

Se uma etapa mira um canal que o contato não tem (por exemplo, uma etapa de e-mail para um host sem endereço de e-mail), essa etapa é pulada — o resto da sequência continua rodando, e o pulo é registrado no histórico de execuções com o motivo.