Como enviar consentimento para a Klaviyo via Zapier

O que você vai aprender

Saiba como criar um webhook personalizado do Zapier para enviar consentimento de SMS para a Klaviyo. Você pode modificar facilmente as instruções deste guia para enviar consentimento por e-mail também.

As etapas abaixo ajudarão você a criar um Zap usando um webhook (também chamado de catch hook) que aciona uma ação de script em Python. O script envia uma chamada de API para o Klaviyo para inscrever endereços de e-mail e números de telefone em uma lista.

Sobre a integração

Este guia usa uma ação de código do Zapier que executa um script em Python quando o acionador é detectado. Com esta solução, você pode mapear campos para os tipos de dados que os ponto de extremidade do Klaviyo exigem, especificamente os ponto de extremidade de Inscrever perfis e Cancelar inscrição de perfis.

Configurar webhook do Zapier

1. Faça login na sua conta do Zapier.
2. Na página principal do Zapier, selecione +Criar e, em seguida, selecione Zap.
3. Digite um nome para seu novo Zap (por exemplo, webhook da Klaviyo).
4. Procure por webhook e selecione Webhooks by Zapier no menu Trigger.
   

5. No próximo menu, selecione Catch Hook nas opções de Evento de gatilho.
   

6. Clique em Continuar.
7. Selecione a aba Teste.
8. Copie o URL do webhook que o Zapier fornece para que você envie suas solicitações.
   

9. Antes de testar, você precisará enviar dados de teste para o seu webhook. Consulte nosso guia Como enviar dados de teste para o Zapier para mais informações. Verifique se os números de telefone estão formatados corretamente ao enviar dados de teste.
10. Depois de enviar os dados de teste para o webhook, clique em Testar acionamento (na guia Teste).
    

11. Se a solicitação for bem-sucedida, você verá uma mensagem de sucesso e os dados de teste serão preenchidos abaixo da mensagem de sucesso, semelhante ao exemplo abaixo:
    

12. Quando o gatilho estiver funcionando, clique em Continuar com o registro selecionado.

Configurar a ação do Zapier

1. No menu Ação, digite Code by Zapier na caixa de pesquisa e selecione a opção na lista.
   

2. Clique em Escolher um evento > Executar Python.
   

3. Clique em Continuar.

Configure o mapeamento de campos e crie a lógica do script

1. Configure o mapeamento de campos para correlacionar os dados de entrada na tabela abaixo com os dados de teste corretos que você enviou anteriormente.
   

1. Adicione um script como o abaixo na caixa de código:
   

import requests

# configuring sms subscribe or unsubscribe call
if (input_data["sms_consent"] == "true" or input_data["sms_consent"] == "True" or input_data["sms_consent"] == "TRUE"):
  url = "https://a.klaviyo.com/api/profile-subscription-bulk-create-jobs/"  payload = { "data": {
        "type": "profile-subscription-bulk-create-job",
        "attributes": {
            "profiles": { "data": [
                    {
                        "type": "profile",
                        "attributes": {
                            "email": input_data["email"],
                            "phone_number": input_data["phone_number"],
                            "subscriptions": {
                                "sms": { "marketing": { "consent": "SUBSCRIBED" } }
                            }
                        }
                    }
                ] }
        },
        "relationships": { "list": { "data": {
                    "type": "list",
                    "id": "LIST_ID"
                } } }
    } }

elif (input_data["sms_consent"] == "false" or input_data["sms_consent"] == "False" or input_data["sms_consent"] == "FALSE"):  url = "https://a.klaviyo.com/api/profile-subscription-bulk-delete-jobs/"
  payload = { "data": {
        "type": "profile-subscription-bulk-delete-job",
        "attributes": {
            "profiles": { "data": [
                    {
                        "type": "profile",
                        "attributes": {
                            "email": input_data["email"],
                            "phone_number": input_data["phone_number"],
                        }
                    }
                ] }
        },
        "relationships": { "list": { "data": {
                    "type": "list",
                    "id": "LIST_ID"
                } } }
    } }
headers = {
    "accept": "application/json",
    "revision": "2024-05-15",
    "content-type": "application/json",
    "Authorization": "Klaviyo-API-Key your-private-api-key"
}

response = requests.post(url, json=payload, headers=headers)

# Zapier requires an 'output' object
output = {"response text": response.text}

1. Substitua your-private-api-keypela sua chave de API privada da Klaviyo.
   

1. Substitua o LIST_ID (nos dois locais) pelo ID da lista do Klaviyo para a qual você quer enviar os dados do Zapier. Você pode encontrar o ID da sua lista no Klaviyo acessando Público > Listas e segmentos > Configurações. Se você quiser inscrever pessoas imediatamente sem uma confirmação (o que pode ser útil durante os testes), verifique se sua lista está definida como opt-in único (encontrado na guia Consentimento nas configurações da lista).
2. Clique em Continuar e, em seguida, clique em Testar etapa.
3. Se o teste for bem-sucedido, você verá uma resposta sem erros, como a mostrada abaixo:
   

4. Você também pode verificar se o teste foi bem-sucedido no Klaviyo acessando sua lista e garantindo que o perfil foi adicionado.
   

5. Quando o teste for bem-sucedido, clique em Publicar para publicar seu zap. Se o teste não for bem-sucedido, confira nossas dicas de solução de problemas para problemas comuns.

Dicas para solucionar problemas

A seguir, estão alguns problemas comuns que você pode encontrar ao configurar o webhook do Zapier. Se você encontrar qualquer outro problema, pode entrar em contato com a Klaviyo Community para receber mais orientações.

Fim de linha ao analisar literal de string

Se você vir esse erro, então está faltando uma aspa em torno de uma das suas variáveis. Verifique o ID da lista e a chave de API privada para garantir que eles estejam entre aspas dos dois lados.

SyntaxError: sintaxe inválida

Se você vir esse erro, remova os comentários no código Python (qualquer linha que comece com #).

Recursos adicionais