Neste passo a passo, você vai aprender como enviar dados de chamados criados na TomTicket para outras ferramentas web via Pluga Webhooks. Vamos lá!
Acesse o painel da Pluga e clique no botão "CRIAR AUTOMATIZAÇÃO" para iniciar a criação de sua automatização:
Na página seguinte, dê um nome à sua automatização:
Na sequência, selecione o Pluga Webhooks como ferramenta e o gatilho "Nova requisição na API".
Depois, é só clicar em "CONTINUAR":
Em seguida, clique em “CONECTAR NOVA CONTA”:
Dê um nome à conta que você está criando, para facilitar a identificação em futuras automatizações que você vá criar.
Agora chegou o momento de você indicar para a Pluga alguns dados importantes para que possamos capturar os dados na API da TomTicket e enviar para outras ferramentas automaticamente.
👉 O primeiro passo é inserir a URL da API onde a Pluga localizará os dados de chamados criados: https://api.tomticket.com/v2.0/ticket/list
👉 Em seguida, vamos definir a chave dos dados. Ou seja, qual é o tipo de dado que está sendo coletado na TomTicket. Para novos tickets criados utilizaremos a chave “data”:
👉 O próximo passo é mapear qual chave contém a informação única sobre os dados capturados. Neste caso, a chave é o identificador do chamado, “id”:
👉 Agora que já identificamos a URL de origem dos dados, o tipo de informação e a chave única que identifica cada chamado, é hora de indicarmos os parâmetros das buscas que serão realizadas na TomTicket. Como desejamos retornar todos os parâmetros dos chamados abertos, utilizaremos apenas “{}” neste campo.
👉 Por fim, precisamos indicar o token de acesso à TomTicket, para que as buscas à API da TomTicket sejam autenticadas.
Como criar seu Token de Acesso na TomTicket
Para criar um token siga as instruções abaixo:
- No Painel Administrativo acesse o menu Gestão › Configurações da Conta
- No menu "Configurações da conta", clique em API
- Clique no botão Novo Token;
Uma janela se abrirá. Nela, insira uma descrição para o Token que facilite sua identificação no futuro e, caso você deseje criar alguma restrição de IP, insira aqui o endereço que deseja restringir. Deixaremos este campo em branco para que não haja essa limitação.
Por fim, selecione o tempo de expiração deste token. Vamos selecionar a opção "Não expira" para que o acesso não seja interrompido e a automatização funcione normalmente por período indeterminado. Também vamos deixar marcada a opção “Pode criar e modificar dados”.
6. Depois, é só clicar em "Criar Token".
Agora, você verá o Token recém criado está listado na tela de Tokens da API na TomTicket.
Clique no ícone 📋 para copiar o token em sua área de trabalho.
Cole esta informação em um documento de texto para que possa utilizá-la em seguida.
Prontinho! Você já pode retornar à Pluga para finalizar sua conexão de conta.
Com o token em mãos, devemos preencher os headers da seguinte forma:
{ "Authorization": "Bearer {SEU-TOKEN-AQUI}" } |
Assim:
O campo Basic Auth não é necessário para realizar a integração com a TomTicket. Por isso, deixaremos ele em branco.
Ótimo! Agora que está tudo certo, vamos configurar o mapeamento da sua automatização.
Para isso, clique em “CONTINUAR”.
Na etapa seguinte, escolha a ferramenta de destino e a ação desejada e selecione a sua conta ou conecte uma nova.
Por último, mapeie as informações que a ferramenta de destino vai receber da TomTicket.
Após terminar o mapeamento, é só clicar no botão "CONTINUAR" no fim da página.
Depois de configurar a primeira ferramenta de destino, você pode decidir se sua automatização já está pronta ou se você quer adicionar novas ferramentas.
Caso seu fluxo já esteja pronto, é só clicar em "FINALIZAR AUTOMATIZAÇÃO".
Pronto! A ferramenta TomTicket já está pronta para enviar informações para outras ferramentas, e agora é só deixar os robôs da Pluga trabalharem por você. o/