Inkit

A Inkit e a Braze ajudam organizações a gerar e distribuir documentos de forma segura, tanto em meio digital quanto por mala direta.

A integração entre o Braze e o Inkit permite gerar documentos e enviá-los por mala direta aos usuários do Braze com webhooks do Braze.

Pré-requisitos

Integração

Etapa 1: crie um modelo da Inkit

Na plataforma da Inkit, crie um modelo para ser usado na sua campanha da Braze em HTML, Word, PowerPoint, Excel ou PDF. Consulte a documentação do Inkit para saber mais.

Etapa 2: Crie seu modelo de webhook do Braze

Para criar um modelo de webhook Inkit a ser usado em futuras campanhas ou Canvas, navegue até Modelos > Modelos de webhook na plataforma Braze.

Se você quiser criar uma campanha única de webhook Inkit ou usar um modelo existente, selecione Webhook no Braze ao criar uma nova campanha.

Depois de selecionar o modelo de webhook da Inkit, você verá o seguinte:

• URL do webhook: Em branco
• Corpo da solicitação: Texto bruto

No campo de URL do webhook, você precisará criar e inserir um URL do webhook da Inkit.

Cabeçalhos de solicitação e método

A Inkit requer um HTTP Header para autorização que inclua sua chave de API da Inkit codificada em base 64. O seguinte já estará incluído no modelo como um par de valores-chave, mas na guia Settings (Configurações), você deve substituir o <INKIT_API_TOKEN> pela sua chave de API do Inkit.

• Método HTTP: POST
• Cabeçalho da solicitação:
  • Autorização: Básico {{ '<INKIT_API_TOKEN>' | base64_encode }}
  • Content-Type: application/json

Corpo da solicitação

Certifique-se de que seu Liquid corresponda aos atributos personalizados adequados associados aos seguintes campos obrigatórios e opcionais. Você também pode adicionar campos de dados personalizados a qualquer solicitação.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
{
  "api_token": "<INKIT_API_TOKEN>",
  "template_id": "<INKIT_TEMPLATE_ID>",
  "first_name": "{{${first_name}}}",
  "last_name": "{{${last_name}}}",
  "email": "{{${email_address}}}",
  "company": "{{custom_attribute.${company_name}}}",
  "phone" : "{{${phone_number}}}",
  "address_line_1": "{{custom_attribute.${address}}}",
  "address_line_2": "{{custom_attribute.${address2}}}",
  "address_city": "{{${city}}}",
  "address_state": "{{custom_attribute.${state}}}",
  "address_zip": "{{custom_attribute.${zip}}}",
  "address_country": "{{${country}}}",
  "source" : "Braze"
}

Etapa 3: veja uma prévia da sua solicitação

Seu texto bruto será automaticamente destacado se for uma tag Braze aplicável. As tags street, unit, state e zip devem ser configuradas como atributos personalizados para enviar esse Webhook.

Pré-visualize a solicitação no painel Preview (Pré-visualização ) ou navegue até a guia Test (Teste ), onde é possível selecionar um usuário aleatório, um usuário existente ou personalizar o seu próprio usuário para testar o webhook.