Como sincronizar o consentimento de SMS com o PAR Punchh
O que você vai aprender
Saiba quais dados são sincronizados do PAR Punchh para a Klaviyo e onde visualizá-los. Isso inclui dados relacionados à atividade da conta, recompensas e check-ins.
Antes de continuar com este artigo, se ainda não fez isso, leia nosso Guia de introdução sobre PAR Punchh para obter instruções passo a passo sobre a integração.
Antes de começar
- Confirme se você já integrou o PAR Punchh ao Klaviyo. Saiba como no nosso guia Guia de introdução ao PAR Punchh.
- Certifique-se de que você configurou o SMS no Klaviyo e tem uma lista de SMS configurada como inscrição em duas etapas. Saiba mais sobre o processo de inscrição em duas etapas.
- Verifique se você tem privilégios de acesso de administrador ou semelhantes na sua conta PAR Punchh, incluindo acesso às seções Whitelabel e Guests do painel do Punchh. Se você não vir essas seções, entre em contato com seu representante da Punchh.
- Garanta que a experiência de cadastro no Punchh colete o consentimento de SMS separadamente do consentimento de e-mail e exiba uma linguagem de divulgação de SMS em conformidade no momento da coleta. Saiba mais sobre coleta de consentimento de SMS e configuração da sua linguagem de divulgação de SMS.
A Klaviyo só sincroniza o consentimento de SMS coletado no Punchh daqui para a frente, a partir do momento em que você concluir a configuração abaixo. A Klaviyo não preenche retroativamente o consentimento de SMS para convidados que optaram por receber antes de a sincronização ser ativada.
Como configurar a sincronização de consentimento de SMS no Punchh
Há duas coisas para configurar no Punchh:
- Um app OAuth, que fornece o ID do cliente e o segredo que a Klaviyo usa para gravar o consentimento confirmado de volta no Punchh.
- Um campo de perfil de convidado, onde o Punchh armazena a adesão ao marketing por SMS de cada convidado.
Crie um app OAuth e capture suas credenciais
- Faça login no seu administrador do PAR Punchh.
- Navegue até Whitelabel > Apps OAuth > Novo aplicativo. Para mais informações, consulte este artigo do Help Center do Punchh.
- Crie o aplicativo. A URL de callback e as configurações de SSO não são usadas por esta integração, então você pode deixá-las com os valores padrão.
- Copie o Client ID e o Secret e salve-os em um local seguro. Você vai inserir os dois no Klaviyo.
- Solicite sua chave empresarial do POS ao seu representante da Punchh e salve-a em um local seguro. Você também vai inserir isso no Klaviyo.
Se você não vir a seção Whitelabel no seu painel do Punchh, ela não foi ativada para o seu usuário. Entre em contato com seu representante do Punchh ou com o Gerente de Customer Success para solicitar acesso ou para que o app OAuth seja criado em seu nome.

Configure seu campo de perfil
A Punchh armazena a opção de recebimento de marketing por SMS de cada cliente em um campo personalizado do perfil do cliente. A Klaviyo procura esse campo pelo nome em todos os webhooks de cliente, então ele precisa ser configurado exatamente como descrito abaixo, ou a sincronização não vai funcionar.
- No admin do PAR Punchh, navegue até Guests > Configurações de Campo de Perfil.
- Crie um novo campo de perfil usando os seguintes valores:
- Código:
klaviyo_sms_consent_flag - Tipo: Múltipla escolha – resposta única
- Tamanho: 5
- Obrigatório: Sim
- Atualizável: Sim
- Valores: Verdadeiro|Falso
3. Salve o campo de perfil.
4. Confirme se a caixa de seleção de consentimento de marketing por SMS no seu formulário de registro (iFrame ou aplicativo para celular) grava nesse campo de perfil.
O valor de Código deve ser exatamente klaviyo_sms_consent_flag, em letras minúsculas. Esse valor não pode ser configurado na Klaviyo. Se o código não corresponder, o Punchh ainda enviará webhooks de convidados para a Klaviyo, mas a Klaviyo não encontrará um valor de consentimento neles e nenhum consentimento de SMS será sincronizado.
Se você não vir Configurações de campos de perfil em Convidados no seu painel do Punchh, entre em contato com o seu representante do Punchh para ativar a configuração de campos de perfil personalizados para a sua empresa.
Como esta caixa de seleção é o ponto em que seus visitantes dão consentimento para marketing por SMS, ela deve ser acompanhada por uma linguagem de divulgação de SMS em conformidade e deve ser separada de qualquer caixa de seleção de consentimento por e-mail. A mensagem de inscrição em duas etapas da Klaviyo é uma confirmação, não uma divulgação. Saiba mais sobre a coleta de consentimento para SMS.

Configurar a sincronização de consentimento de SMS no Klaviyo
Depois de ter o ID do cliente, o secret e a chave da empresa, ative a sincronização no Klaviyo.
- Na Klaviyo, selecione a aba Integrações.
- Selecione Punchh.
- Marque a configuração para sincronizar futuros assinantes de SMS do Punchh com a Klaviyo.
- Selecione sua lista principal de SMS (ou outra lista, se preferir) no menu suspenso.
- Insira as seguintes credenciais:
- ID do cliente: o ID do cliente do app OAuth no Punchh.
- Secret: o secret do app OAuth na Punchh.
- Chave da empresa: a chave comercial do seu PDV, que você pode solicitar ao seu representante da Punchh.
6. Clique em Salvar.
A lista selecionada precisa estar definida como inscrição em duas etapas no Klaviyo. A inscrição em duas etapas é o que torna essa sincronização compatível, e não pode ser ignorada. Saiba como verificar e alterar essa configuração em nosso guia sobre o processo de inscrição em duas etapas.
Se você estiver configurando a integração do Punchh pela primeira vez, vai concluir essas mesmas etapas como parte do fluxo de configuração inicial. Consulte o Guia de introdução ao PAR Punchh.

Como funciona a sincronização de consentimento de SMS da Punchh
Depois que os dois lados estiverem configurados, os fluxos de consentimento de SMS entre a Punchh e a Klaviyo acontecem automaticamente:
- Um convidado aceita receber SMS no Punchh. Quando alguém marca a caixa de consentimento de marketing por SMS durante o cadastro (ou, mais tarde, ao atualizar o perfil), o Punchh define o campo de perfil
klaviyo_sms_consent_flagcomo true e envia um webhook de convidado para a Klaviyo. - Klaviyo inicia o processo de inscrição em duas etapas. Quando a Klaviyo recebe um webhook em que o campo do perfil é verdadeiro e um número de telefone está presente, ela inscreve esse número de telefone na lista de SMS que você selecionou nas configurações de integrações do Punchh. Como essa lista está configurada como inscrição em duas etapas, a Klaviyo envia automaticamente ao convidado uma mensagem de texto de confirmação.
- O convidado confirma. O convidado responde ao texto de inscrição em duas etapas para confirmar a assinatura. Até que ele responda, ele não é um membro da lista e não receberá nenhuma mensagem de marketing sua.
- O convidado é adicionado à sua lista. Depois da confirmação, o convidado é adicionado à lista de SMS especificada nas configurações das integrações da Punchh, e o perfil da Klaviyo registra o consentimento de marketing por SMS com a origem do consentimento como Punchh.
- A Klaviyo confirma de volta para o Punchh. Em seguida, a Klaviyo envia essa confirmação de volta para o Punchh, que define o campo nativo sms_subscription do convidado como true. Isso mantém os dois sistemas sincronizados sobre quem é um assinante de SMS confirmado.
Resultado
Agora você configurou a sincronização de consentimento de SMS entre o PAR Punchh e o Klaviyo. Os convidados que aceitarem receber marketing por SMS no Punchh receberão uma mensagem de texto de inscrição em duas etapas do Klaviyo e, depois que confirmarem, serão adicionados à sua lista de SMS do Klaviyo e marcados como inscrever-se no Punchh.
Recursos adicionais
- Guia de introdução com PAR Punchh
Saiba como fazer a integração com o PAR Punchh, uma plataforma completa de fidelidade e engajamento para restaurantes e lojas de conveniência.
- Referência de dados PAR Punchh
Saiba quais dados são sincronizados do PAR Punchh para a Klaviyo e onde você pode visualizá-los. Isso inclui dados relacionados à atividade da conta, recompensas e check-ins.
- Entenda o processo de inscrição em duas etapas
Saiba a diferença entre inscrição simples e em duas etapas, por que a inscrição em duas etapas é importante para SMS e e-mail e como atualizar as configurações de listas ou palavras-chave na Klaviyo.
- Como funciona a coleta de consentimento por SMS
Saiba mais sobre o consentimento de SMS, incluindo o que conta como consentimento de SMS, como você pode coletá-lo e como funcionam as reinscrições. O consentimento de SMS se refere a se alguém está inscrito (ou seja, se concordou em receber mensagens de texto de marketing da sua marca).
- Como configurar o idioma de divulgação de SMS
Saiba como criar linguagem de divulgação de SMS no nível da conta, facilitando a adição aos seus formulários de registro e páginas de inscrição.