Este documento orienta-o na criação de um Zap no Zapier

## 1. Criação de um Zap
O principal objetivo do Zapier é ligar aplicações para concluir uma determinada tarefa. 
Essa ligação chama-se Zap. Depois de aceitar o convite, será redirecionado para o 
site do Zapier, onde deve clicar no botão `Make Zap`.

## 2. Escolha do acionador do Zap
Cada Zap precisa de uma aplicação que ative as restantes aplicações incluídas no Zap. 
Como a integração da BulkGate não contém acionadores, é necessário escolher outra 
aplicação que funcione como ponto de partida do nosso Zap. No nosso exemplo, vamos utilizar a integração do Gmail.

![Escolher o acionador](helpdesk:zapier-bulkgate-zap/choose_app_2)

### 1. Escolha do acionador    
No nosso exemplo, vamos criar um Zap que será ativado sempre que recebermos um e-mail num determinado 
endereço de e-mail. Cada acionador ou ação precisa de um conjunto de parâmetros para funcionar corretamente. 
O acionador `New email` requer a ligação a uma conta de e-mail e a uma caixa de correio. 

![Novo e-mail](helpdesk:zapier-bulkgate-zap/choose_trigger2)

### 2. Teste
Cada acionador/ação requer um teste de funcionamento. Sem esse teste, não é possível passar dados 
para o passo seguinte. O teste funciona da seguinte forma: o Zapier verifica a caixa de correio indicada para testar a sua disponibilidade. 
O conteúdo da mensagem devolvida fica disponível para ser passado ao passo seguinte.
  
## 3. Integração da BulkGate
Agora que temos o acionador configurado, vamos ligar a integração da BulkGate. O nosso exemplo é o seguinte: 
após a receção de um e-mail, é enviada uma notificação por SMS para um número de telefone indicado.

### 1. Selecionar a aplicação
Escolhemos a BulkGate como aplicação do segundo passo.

![BulkGate](helpdesk:zapier-bulkgate-zap/setup_action_2)

### 2. Selecionar a ação
Escolhemos a ação `Send transactional SMS`.

![Escolher a ação](helpdesk:zapier-bulkgate-zap/choose_action_2)

### 3. Autenticação
É necessário indicar os dados de autenticação (`Application ID`, `Application token`). Para obter estes dados, consulte o [guia de configuração da API BulkGate](https://www.bulkgate.com/pt/documentacao/administracao-da-api/administracao-de-apis/). 

![Adicionar ligação](helpdesk:zapier-bulkgate-zap/add_connection_2)

![Escolher a ligação](helpdesk:zapier-bulkgate-zap/choose_connection_2)

![Autenticação](helpdesk:zapier-bulkgate-zap/authentication)

### 4. Parâmetros de entrada
Introduzimos os parâmetros de entrada necessários para enviar um SMS transacional. Para mais informações sobre os parâmetros de entrada, consulte a [documentação da API BulkGate](https://www.bulkgate.com/pt/documentacao/simple-api/simple-transactional/).

![Parâmetros do SMS transacional](helpdesk:zapier-bulkgate-zap/action_send_transactional_2)

<!--
### 5. Teste da mensagem transacional
Agora podemos testar o funcionamento do segundo passo do nosso Zap, ou seja, enviar um SMS de teste com base nos parâmetros indicados.

![Teste transacional](helpdesk:zapier-bulkgate-zap/test_send_transactional)
  
  
### 6. Relatório de entrega
O nosso Zap funciona agora da seguinte forma: se recebermos um e-mail, é enviado um SMS de notificação. 
Em seguida, alargamos a funcionalidade com a receção de um relatório de entrega, clicando no botão `Add step` 
e escolhendo a aplicação BulkGate com a ação `Get delivery report`.  


![Relatório de entrega](helpdesk:zapier-bulkgate-zap/passing_data)

### 7. Teste do relatório de entrega 
Esta ação requer o `SMS ID` passado a partir do segundo passo. Agora testamos este 
passo, recebendo um relatório de entrega do SMS enviado no passo anterior.

![Teste do relatório de entrega](helpdesk:zapier-bulkgate-zap/final_tested)
-->

### 5. Pronto a utilizar
O Zap está agora concluído e podemos dar-lhe o nome que quisermos. Após a ativação, o Zapier verificará a caixa de correio a cada 15 minutos. Se não for possível ativar o Zap, é porque qualquer Zap com mais de dois passos precisa de uma conta `Premium/trial` para funcionar.

![Atribuir um nome ao Zap](helpdesk:zapier-bulkgate-zap/naming_zap_2)