Question 1

Ferramenta "Formatar número de telefone"

Accepted Answer

Etapa 1. Adicionando a ferramenta

Encontre a ferramenta na seção "Automações" e adicione-a entre as etapas.

Etapa 2. Configurando a ferramenta

Na segunda etapa será preciso preencher os campos “Número de telefone original” e “Máscara do número de telefone”.

Primeiramente, selecione o número de telefone original na lista suspensa do sistema de envio. No exemplo, usamos o número de telefone do lead do canal de publicidade do Google Ads:

Depois, converta o número usando uma máscara. Selecione na lista o formato que você precisa:

Se você não inserir o código do país, o número de telefone será transmitido sem um código. Se nenhuma das máscaras funcionar da maneira que você precisa, você pode criar uma configuração própria conforme esse exemplo: ({{##########}}). Nesse caso, a quantidade de hashtags é a quantidade de números do telefone.
Se você inserir o código do país, todos os símbolos # serão substituídos pelos dígitos do número de telefone com o código desejado de acordo com a máscara selecionada.

Etapa 3. Atualizando o serviço de destino

Depois de definir a etapa “Formatar o número de telefone”, ad

Question 2

Filtro de dados dos gatilhos

Accepted Answer

Essa configuração é útil tanto para todos os tipos de gatilhos. No Webhook, permite que você rastreie o ID de uma transação ou entidade e, se o aplicativo repentinamente enviar várias solicitações ao Webhook ao mesmo tempo, será protegido contra “spam”. Isso é também necessário para os gatilhos de API, que pesquisam o aplicativo a cada cinco minutos e recebem as mesmas entidades.

As configurações permitirão gravar os valores dos campos, dentro do histórico de uma automação, para que o mesmo dado não entre na automação várias vezes.

Rastrear duplicatas de entidades em cada requisição

Neste caso, um ou mais campos são selecionados (apenas campos do tipo string e integer estão disponíveis). Quando um gatilho em uma automação é lançado, o valor que veio neste campo é gravado. Se uma entidade for encontrada repetidamente, ou seja, com valor completamente correspondente no mesmo campo, o gatilho não será lançado.

O ID da entidade recebida pode ser usado para esse rastreio. A configuração é aplicável para gatilhos que capturam o evento de criação (notificações únicas).

Monitorar a modificação da data de atualização da entidade

Para tal monitoramento, apenas um campo é selecionado (somente campos com o tipo DateTime estão disponíveis). Esta caixa de seleção só pode ser usada em conjunto com a primeira. Quando um gatilho é lançado em uma automação, além

Question 3

Workflow do Integrador de Apps

Accepted Answer

Primeiramente, criamos uma aplicação, damos um nome a ela e estruturamos o processo que vai funcionar como recebimento de dados da autorização e atualização. Se for preciso, também deve ser criado um token de acesso e um "template", a fim de preencher a solicitação de API com os dados de autorização.

Além disso, é possível usar a autorização criada em outras entidades, portanto, não será necessário adicionar variáveis a cada vez nas solicitações, nas quais os dados de autorização são colocados.

Também existe a possibilidade de criar as entidades necessárias para que a automação (bundle) funcione. Por exemplo, "listas", que podem ser estáticas e dinâmicas, "listas de campos personalizados" e "Webhook catcher". Todas essas entidades são vinculadas a gatilhos ou ações.

Com isso, um gatilho ou ação é criado, dependendo do que é necessário da automação, os campos necessários são estabelecidos, entidades adicionais são vinculadas e o comportamento da própria API de solicitação é configurado.

Question 4

Tipos e componentes de gatilhos

Accepted Answer

Um gatilho pode reagir à criação ou modificação (rastreamento do parâmetro "data de modificação") de uma entidade no aplicativo.

Cada gatilho possui seu próprio “filtro interno”, que indica quando ele precisa ser iniciado. Nesse processo, é feita uma validação comparando as características definidas. Então, se forem iguais ao valor selecionado, um determinado tipo de evento vem com um Webhook, ou o gatilho API faz uma solicitação para um URL a fim de obter uma entidade específica.

Tipos de gatilho

Existem dois modelos de comportamento de gatilho, que devem ser selecionados na criação. São eles:

Webhook - o gatilho responde quando uma solicitação HTTP chega à URL do Webhook (criado e vinculado à conexão). Para cada gatilho é configurado um filtro, que indica que um determinado conjunto de variáveis, com o valor especificado, deve entrar na solicitação.
Solicitação de saída da API - o gatilho "investiga" de forma independente o aplicativo a cada cinco minutos e faz uma solicitação HTTP para um determinado URL, recebendo uma lista de entidades e filtrando-as pelos parâmetros selecionados (por exemplo ID).

Os tipos de gatilho podem ser combinados sem restrições.

Componentes de gatilho

Um gatilho tem três componentes principais:

Campos - criam-se os campos de gatilho para armazenar os valores recebidos como resultad

Question 5

Modelo API

Accepted Answer

O cenário principal é uma solicitação de lista de entidades, especificando os parâmetros de duas datas na solicitação (data de modificação / data de criação).

O gatilho cria e envia as solicitações, utilizando a URL que foi configurada para cada tipo de solicitação. A autorização é vinculada para enviar os parâmetros de autenticação, junto com o corpo da solicitação e seus respectivos campos, o analisador de resposta e o tratamento de erros.

Datas em solicitações HTTP

O gatilho da API no widget tem dois parâmetros adicionais na guia de parâmetros do sistema: Tempo de requisição (de) e Tempo de requisição (até):

O primeiro parâmetro deve ser, no mínimo, uma hora a menos em relação a hora do lançamento da automação (deve ser uma data/hora retroativa). O segundo parâmetro transfere a própria data e hora do lançamento. Esses parâmetros são dinâmicos e mudam automaticamente a cada cinco minutos, bastando especificá-los corretamente na solicitação. A Albato formatará as datas e transferi-las para o aplicativo de forma independente, quando a automação com um gatilho for acionada, ao iniciar uma requisição.

Assim, a cada cinco minutos o gatilho obtém uma lista de entidades criadas / modificadas na última hora.

Recebendo uma matriz de dados

Como o modelo de API do gatilho solicita listas de entidades, quase semp

Question 6

Campos dos gatilhos

Accepted Answer

Tendo configurado a aba de resposta nas solicitações, deve-se mapear quais serão os valores das variáveis da resposta dessa solicitação e em qual campo elas devem ser impressas. É este o valor que será transmitido na automação quando o gatilho disparar.

Criar campos

Para criar um campo clique no botão Adicionar campo e preencha os campos no pop-up que vai aparecer. A lista dos campos configuráveis contempla:

Código do campo - campo para definir o valor do dado sendo criado. Deve seguir as características da documentação API do aplicativo adicionado.
Nome - o nome do campo que estará aparecendo na interface para usuários finais.
Nome Alternativo - o nome do campo que estará aparecendo para usuários finais, em possíveis interfaces distintas, como diferentes idiomas selecionados.
Tipo - a definição do tipo do campo também deve seguir as configurações e características descritas na documentação API em questão.

Após criado, cada campo é editável. Basta clicar no botão de edição:

Tipos de campos

Cada campo tem seu próprio tipo. Essa definição afeta o que esperamos receber como resultado do campo.

Artigos lidos frequentemente

Buscar em todas as categorias