Pular para o conteúdo principal

Integração Zapier com Woovi

A Zapier é uma plataforma poderosa que viabiliza a integração fluida de mais de 5.000 aplicativos diversos em fluxos de trabalho automatizados e interconectados.

Com o selo oficial da Woovi, o nosso aplicativo está agora disponível na ampla gama de apps listados na Zapier. Isso abre a porta para a integração dos serviços de Pix com outras aplicações, incluindo, por exemplo, a capacidade de sincronizar dados com planilhas do Google e envio de notificações no Slack.

O que você pode alcançar com o app da Woovi?

Ao aproveitar o aplicativo da Woovi, você desbloqueia um universo de oportunidades. Aqui estão alguns exemplos de integrações práticas:

  • Notificações no Slack: Receba alertas instantâneos no Slack para novas cobranças na Woovi.
  • Registro em Planilhas Google: Mantenha registros automáticos de novos clientes em planilhas Google.
  • Integração com Email Marketing: Adicione automaticamente novos clientes da Woovi à sua lista de contatos de email marketing.
  • Gerenciamento de Reembolsos: Envie notificações de reembolso aos clientes e mantenha registros internos.
  • Sincronização Financeira: Crie entradas financeiras em plataformas como QuickBooks para novas cobranças na Woovi.

Ações e gatilhos

Nosso aplicativo possui as seguintes ações (actions) que você pode utilizar em conjunto com outros aplicativos:

  • Criar uma cobrança
  • Remover uma cobrança
  • Criar um cliente
  • Criar reembolso de uma cobrança

Você também pode utilizar o gatilho (trigger) de webhook, que permite ativar outras ações (como enviar uma notificação no Slack) quando um evento acontece (como uma cobrança sendo paga).

Autenticação

Ao utilizar alguma triger ou action da Woovi em seu fluxo no Zapier, é necessário se autenticar.

Isso é realizado na seção Account, através do botão Sign In:

Seção de configuração da conta Zapier

Ao apertar esse botão, uma nova janela será aberta, onde você deverá adicionar o seu App ID e um nome para sua conta (no campo App name).

Ações

Como adicionar uma ação da Woovi

Em seu fluxo Zapier, adicione uma nova ação pesquisando por Woovi no início de sua action:

Pesquisando pelo app da Woovi no criador de actions

Agora é necessário selecionar um evento, que diz qual ação tomar. Por exemplo, aqui estamos selecionando o evento Create charge para criação de uma cobrança:

Selecionando o evento para criar uma cobrança

Devemos estar na seção Account no momento, onde a autenticação deve ser feita.

Após a autenticação, é o momento de configurar sua action na seção Action, de acordo com o evento dela:

Configurando a action de criação de cobrança

Tendo configurado a nossa action, agora você deve estar na seção Test para testes da action:

Seção de testes de uma action

Ao apertar o botão Test action você efetuará o teste dela:

Botão para testar uma action

Como criar uma cobrança?

Neste cenário de exemplo, faremos uso do Google Planilhas. Aqui, uma planilha de cobranças será configurada, onde cada nova linha inserida resultará na geração automática de uma cobrança.

Em primeiro lugar, crie uma planilha com os seguintes campos e adicione uma nova linha:

Planilha de exemplo para criação de cobranças

Após isso crie um Zap com o trigger Ǹew Spreadsheet Row (nova linha na planilha) do app Google Sheets.

Tendo configurado e testado a trigger, adicione uma nova action da Woovi com o evento Create charge (criar cobrança).

Ajuste os campos da ação na seção Action de forma a coincidirem com as colunas da planilha:

Planilha de exemplo para criação de cobranças

No campo Type selecione DYNAMIC para criação de uma cobrança à vista.

Após isso, prossiga para a seção Test para testar o seu fluxo.

Como remover uma cobrança?

Adicione uma action com o evento Delete a charge em seu fluxo do Zapier.

Configure os campos da action na seção Action:

Configurando a action de remover uma cobrança

Como campo da action, temos o id que é onde você deve colocar o correlationID ou o identificador da cobrança.

Como criar um cliente?

Adicione uma action com o evento Create customer em seu fluxo do Zapier.

Configure os campos da action na seção Action:

Configurando a action de criar um cliente

A action possui as seguintes entradas pro cliente:

  • Name (obrigatório): Nome.
  • Email: E-mail do cliente.
  • Phone: Número de telefone.
  • CorrelationID: É o correlationID do cliente, um identificador.
  • Address: Endereço do cliente.
    • Zip Code: Coloque aqui o CEP.
    • Street: A rua do cliente.
    • Number: Número do endereço.
    • Neighborhood: Bairro.
    • City: Cidade.
    • State: Estado do cliente.
    • Complement: Complemento do endereço.
    • Country: País. Por exemplo: BR para Brasil.

Como criar reembolso de uma cobrança?

Adicione uma action com o evento Create a Charge Refund em seu fluxo do Zapier.

Configure os campos da action na seção Action:

Configurando a action de criar um reembolso

A action possui as seguintes entradas:

  • Refund CorrelationID: Seu correlationID para acompanhar este reembolso.
  • Charge Correlation ID: O correlationID da cobrança.
  • Value: Valor do reembolso em centavos.
  • Comment: Comentário da cobrança.

Gatilhos

Como configurar o webhook?

Os webhooks permitem que diferentes sistemas se comuniquem em tempo real, transmitindo dados de forma automática e instantânea.

É possível configurar um webhook no Zapier utilizando um trigger que é acionado sempre que uma cobrança for completamente paga, por exemplo.

Para utilizar, crie um novo Zap e ative o trigger da Woovi.

Ao criar um novo Zap, é possível encontrar o trigger da Woovi pesquisando por woovi:

Pesquisando pelo trigger

Selecione New Webhook Event no campo de evento da trigger:

Selecionando o evento da trigger

Realize a autenticação na seção de Account.

Realizando a autenticação

Configure a trigger:

Configurando a trigger

A trigger possui as seguintes entradas:

  • Webhook Name: Nome do seu webhook. Coloque aqui o nome da sua integração, por exemplo.
  • Event Type: Indica quando a trigger é ativada. No exemplo ela será ativada sempre quando uma cobrança for totalmente paga. Veja as possibilidades de eventos:
    • OPENPIX:CHARGE_CREATED - Uma cobrança foi criada.
    • OPENPIX:CHARGE_COMPLETED - Uma cobrança foi totalmente paga.
    • OPENPIX:CHARGE_EXPIRED - Uma cobrança não foi totalmente paga e expirou.
    • OPENPIX:TRANSACTION_RECEIVED - Uma transação PIX foi recebida.
    • OPENPIX:TRANSACTION_REFUND_RECEIVED - Novo reembolso de transação PIX recebido ou reembolsado.
    • OPENPIX:MOVEMENT_CONFIRMED - A transação do pix referente ao pagamento é confirmada.
    • OPENPIX:MOVEMENT_FAILED - Falha no pagamento é quando o pagamento é aprovado e ocorre um erro.
    • OPENPIX:MOVEMENT_REMOVED - O pagamento foi removido por um usuário.
  • Is Active?: É necessário ativar esta opção para que o webhook funcione.

Agora realize o teste de sua trigger na seção Test:

Testando a trigger