Usando dados de resposta de webhook em sua jornada

Visão geral

Quando você mapeia valores de uma resposta de webhook, o Pushwoosh os armazena como variáveis que você pode usar mais tarde na jornada, em qualquer lugar que você usaria um atributo de Evento.

Nota

Para adicionar um elemento Webhook e configurar o Mapeamento de resposta, consulte Webhook.

Salvar um valor de webhook como uma Tag com o Atualizar perfil do usuário

Um Webhook pode retornar dados de um sistema externo, como um ID de usuário de CRM ou status de assinatura, que o Pushwoosh ainda não armazena no perfil do usuário. O Atualizar perfil do usuário salva valores mapeados como Tags para que você possa usá-los em segmentos, conteúdo dinâmico e etapas posteriores da jornada.

Exemplo: salvar um ID de usuário de CRM como uma Tag

Um novo usuário se inscreve em seu aplicativo, e a jornada cria um registro correspondente em seu CRM. Salvar o ID de usuário de CRM retornado como uma Tag permite que você referencie ou atualize o mesmo registro de CRM posteriormente, por exemplo, de outra jornada ou de uma chamada de Webhook de acompanhamento, em vez de criar um registro duplicado cada vez que o usuário reentra na jornada.

Fluxo da jornada: Entrada baseada em gatilho → Webhook → Atualizar perfil do usuário → encerrar o ramo

1. Crie uma jornada com Entrada baseada em gatilho no evento SignUp.
2. Adicione um elemento Webhook após a etapa de entrada. Dê um nome a ele (por exemplo, Create user in CRM) e defina a URL da solicitação para o endpoint de criação de usuário do seu CRM.
3. Em Mapeamento de resposta, defina o Caminho para o campo de ID na resposta (por exemplo, data.user.id) e o Atributo para crm_user_id.

4. Adicione um elemento Atualizar perfil do usuário após a etapa do Webhook.

5. Em Valor de Tag dinâmico, clique em + Valor dinâmico. Em Tag, selecione a Tag que armazena o ID do CRM (crie-a com antecedência, se necessário). Em Evento, selecione a etapa do webhook pelo nome que você deu a ela (Create user in CRM). Em Valor dinâmico, selecione crm_user_id.

6. Encerre o ramo — adicione um elemento de Saída ou deixe-o sem uma conexão de saída.

Cuidado

Se o valor do webhook estiver ausente para um usuário (a resposta não foi JSON, o Caminho não foi resolvido ou a chamada falhou), o Pushwoosh pula essa atualização de Tag. A Tag mantém seu valor anterior ou permanece não definida, e a jornada continua sem erro nesta etapa. Execute o Teste de webhook antes do lançamento para confirmar seu mapeamento. Saiba mais.

Agendar um atraso a partir de um valor de webhook com o Atraso de tempo

Datas de visita, prazos de renovação e janelas de entrega geralmente residem em um sistema externo de agendamento ou faturamento. Depois que um Webhook mapeia a data da resposta da API, o Atraso de tempo pode pausar a jornada até aquele momento, por exemplo, 2 dias antes de um compromisso, para que a próxima mensagem seja enviada na hora certa.

Exemplo: agendar um lembrete a partir de uma data na resposta

Um usuário marca um compromisso em seu aplicativo. A jornada busca a data da visita em seu sistema de agendamento e envia um lembrete por push 2 dias antes da visita.

1. Crie uma jornada com Entrada baseada em gatilho no evento AppointmentBooked.
2. Adicione um elemento Webhook após a etapa de entrada. Dê um nome a ele (por exemplo, Get appointment details) e defina a URL da solicitação para a API do seu sistema de agendamento.
3. Em Mapeamento de resposta, defina o Caminho para o campo de data na resposta (por exemplo, appointment.date) e o Atributo para visit_date.

4. Adicione um elemento de Atraso de tempo após a etapa do Webhook. Selecione Com base nos dados do usuário/evento, defina Obter data de como Evento, defina Evento para a etapa do webhook pelo nome que você deu a ela (Get appointment details), defina Valor do evento para visit_date e defina o atraso para Antes de 2 Dias.

5. Se os usuários puderem agendar com menos de 2 dias de antecedência da visita, habilite Dividir em ramos se a data estiver no passado ou a data estiver vazia no elemento Atraso de tempo. Isso cria dois ramos, No passado e No futuro. Consulte Dividir ramos quando a data está no passado ou vazia.
6. Adicione uma etapa de Push com sua mensagem de lembrete. Se a divisão estiver habilitada, adicione este Push em ambos os ramos: No passado (enviar imediatamente) e No futuro (após o Atraso de tempo).
7. Encerre cada ramo — adicione um elemento de Saída ou deixe-o sem uma conexão de saída.

Cuidado

Se o valor mapeado estiver ausente ou não for uma data válida, o usuário sai da jornada com um erro nesta etapa.

Se a visita ocorrer em menos de 2 dias, o alvo de Antes de 2 Dias já estará no passado quando o usuário chegar ao Atraso de tempo, e o usuário deixará a jornada sem erro e sem lembrete, a menos que você habilite Dividir em ramos se a data estiver no passado ou a data estiver vazia.

Diferente do Atualizar perfil do usuário, que deixa a Tag inalterada e continua, o Atraso de tempo para o usuário quando a data está ausente, é inválida ou está no passado (sem a divisão de ramos). Certifique-se de que seu webhook retorne de forma confiável uma data em um formato suportado. Execute o Teste de webhook antes do lançamento. Saiba mais.

Pontos a serem considerados

• Sintaxe do caminho: use um caminho separado por pontos (por exemplo, data.user.id). Curingas e filtros não são suportados. Consulte Mapeamento de resposta de webhook para mais detalhes.
• Tamanho da resposta: respostas maiores que 64 KB não são processadas para mapeamento.
• Teste: execute o Teste de webhook no elemento Webhook antes de usar valores mapeados em uma jornada ativa.