Neste artigo
Finalmente liberamos essa função na Albato! E já preparamos um texto para te explicar como usar o Integrador de Apps.
O que isso quer dizer?
Nosso Integrador de Apps possibilita que você mesmo adicione um serviço ao site da Albato para poder trabalhar em suas integrações, sem precisar falar com o suporte sobre a possibilidade de inclusão. Basta que o serviço tenha uma API aberta para poder ser conectada no seu construtor de integrações.
O Integrador de Apps consiste em um conjunto de entidades que de uma forma ou de outra estão conectadas entre si e podem ser utilizadas em diferentes locais, como, por exemplo, “Autorização”, “Gatilho” e “Ação”. A mecânica de inclusão consiste no princípio de “copiar e colar”, basta abrir a documentação da API, copiar o URL da solicitação, as variáveis e colar no Integrador de Apps.
Fluxo de Trabalho
Um aplicativo é criado, um nome é dado a ele, então, se necessário, uma autorização é criada, na qual um método para obter dados de autorização e atualização, se necessário (token de acesso) e um “modelo” para preencher uma solicitação de API com dados de autorização, está configurado. Além disso, você pode 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.
Você pode criar as entidades necessárias para que a integração 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.
Um gatilho ou ação é criado, dependendo do que é necessário da integração, os campos necessários são criados, entidades adicionais são vinculadas e o comportamento da própria API de solicitação é configurado.
Publicação
Depois que gatilhos ou ações forem adicionados, eles ficarão disponíveis apenas na conta pessoal da Albato que criou este aplicativo. Quaisquer alterações que ocorrerem nas configurações do aplicativo ocorrem “instantaneamente” e são aplicadas imediatamente. Mas se você precisa que seu aplicativo esteja disponível para todos os usuários do Albato, você precisará enviar o aplicativo para moderação. No momento da moderação, assim como após a publicação, o aplicativo fica proibido para edição.
Em seguida, o moderador verificará o desempenho de sua integração e, se todos os testes forem bem-sucedidos, seu aplicativo se tornará público e estará disponível para todos os usuários do Albato. Dessa forma, você pode adicionar uma lista enorme de integrações sem desenvolvedor ao seu aplicativo. As integrações com uma variedade de sistemas de CRM, CMS e marketing serão abertas com o seu sistema. Tudo que você precisa fazer é adicionar seu aplicativo ao Controle de versão.
Se for necessário, após a publicação do aplicativo, alterar algo nele, é criada uma nova versão, que é uma cópia integral da versão que é pública.
Nesta versão, você pode adicionar / modificar / excluir todas as entidades. Após todas as alterações, o pedido é enviado para moderação. Depois da criação da versão, na conta pessoal do proprietário do aplicativo, uma nova versão com todas as alterações fica disponível, ela está disponível apenas com o proprietário, a versão publicada funcionará em outras contas Albato. Com a moderação, as versões são “mescladas” e sua nova versão torna-se disponível para todos os usuários.
Vamos considerar o comportamento durante a “fusão” usando o exemplo da entidade “Ação”:
* Uma entidade foi adicionada à versão – os usuários têm novas entidades, ao criar um link, você pode selecionar uma nova ação
* Na versão, a ação existente foi alterada – Para os usuários, em todos os pacotes atuais, a própria etapa foi substituída.
Ou seja, se um campo foi adicionado / removido ou a estrutura da solicitação foi alterada, os usuários não precisam criar um novo link, todas as alterações ocorrerão nos links existentes. Este cenário é adequado quando as alterações são mínimas e não afetam muito o funcionamento da ação, por exemplo, alterar o nome de um campo, adicionar um campo, alterar a estrutura de uma solicitação com os mesmos campos.
* Na versão, a ação foi deletada – Para usuários que já possuem um link com esta ação, o link continuará funcionando, toda a etapa ficará inalterada e as solicitações sairão de acordo com as configurações anteriores. Mas ao tentar criar um novo pacote, o usuário não verá mais esta ação, ela só pode funcionar em pacotes antigos.
O último cenário é possível quando as mudanças são muito grandes (por exemplo, uma mudança na versão da API, devido à qual a autorização mudou ou o conjunto de campos mudou completamente). Você pode simplesmente excluir a ação antiga e criar uma nova, a mesma com o mesmo nome, mas com novas configurações. Como resultado, os usuários nos pacotes antigos terão a versão antiga da ação, mas ao criar um novo pacote e escolher esta ação, eles já terão uma nova etapa que funciona com o novo script.
Gostou da nossa novidade? Conseguiu entender como mexer no nosso Integrador de Apps? Caso tenha dúvidas ainda, criamos um grupo no Facebook para os usuários da Albato tirarem suas dúvidas e compartilharem experiências : [https://www.facebook.com/groups/albatocommunity)
