O Zenvia Customer Cloud permite que você inicie uma automação através de uma chamada de API em um servidor ou sistema terceiro.

Neste artigo, explicamos por que usar API de automação de marketing do Zenvia Customer Cloud e como ela funciona na prática.

A integração de uma API demanda conhecimento técnico avançado, portanto, é importante contar com a ajuda de um desenvolvedor. As informações sobre a API de automação de marketing podem ser consultadas no Zenvia APIs.

Porque usar a API de automação

Imagine que você tenha uma página de cadastro para um evento online sobre estratégias de marketing. Em vez de fornecer imediatamente o link de acesso ao evento assim que alguém preencher o formulário de inscrição, você pode enviar uma comunicação para a pessoa interessada com todas as informações necessárias, incluindo um link exclusivo para acessar o evento.

Nesse caso, a API pode conectar as informações que são coletadas através do seu formulário de cadastro ao disparo de uma campanha automação de marketing.

Em resumo, você inicia uma régua de comunicação através de uma chamada de API em um servidor ou sistema terceiro.

Como funciona a integração da API

Antes de integrar a API, é necessário criar a automação que receberá o estímulo externo. Vamos utilizar o exemplo do formulário de cadastro para o evento online.

Para isso, no menu lateral, acesse Envio de mensagens > Envios e automações e clique em Criar automação. Em seguida, selecione o gatilho API, que é a regra que define a ativação do fluxo.

Com a automação ativa no ZCC, é necessário fazer a integração entre o gatilho que inicia a régua de comunicação - a API - e o seu sistema. Para realizar essa integração, utilizamos o Zapier, um integrador criado para facilitar a comunicação entre softwares.

Criar uma integração com o Zapier

Você já sabe que o Zapier é o facilitador da integração, ou seja, o responsável por conectar uma aplicação com outra para a troca de informações. Para isso:

1. Faça o login no Zapier e selecione o botão laranja +Create Zap, no menu lateral à esquerda. 
2. Escolha o aplicativo de gatilho (trigger).
3. Selecione o gatilho, que é o evento que ocorre no aplicativo que aciona o fluxo de dados do Zapier. Os gatilhos são exibidos de acordo com as possibilidades oferecidas pelo aplicativo selecionado. Nesse caso, os eventos disponíveis são:
   • Nova resposta de formulário (New Form Response): o evento que aciona o fluxo do Zapier é quando uma nova resposta de formulário é recebida;
   • Resposta de formulário nova ou atualizada (New or Updated Form Response): o evento que aciona o fluxo do Zapier quando uma nova resposta de formulário é adicionada ou modificada.
4. Clique em Continue.
5. Selecione a conta que deseja conectar no aplicativo.

Pronto. O próximo passo é adicionar uma ação para o gatilho, ou seja, os dados da API de automação para que a régua se inicie no momento em que o formulário for respondido.

Configurar a ação

1. Selecione o aplicativo para que o Zapier registre uma ação quando o gatilho configurado for acionado. Para fazer isso, pesquise e escolha o aplicativo que deseja conectar ao formulário.
2. Escolha o evento que o Zapier realizará no aplicativo selecionado no momento em que for acionado. No caso, utilizamos como exemplo o aplicativo Webhooks by Zapier.
3. Defina os dados que você deseja enviar para seu aplicativo de ação. Nessa etapa, é necessário combinar os dados da sua automação no Zenvia Customer Cloud com o fluxo do Zapier. Para isso, na automação criada, clique no gatilho para conferir o código da requisição.
   

4. Após combinar todos os campos no Zapier, clique em Continue;

5. O resumo da requisição é exibido e você já pode testar a sua ação para ver se está funcionando conforme o esperado clicando em Test Action. Após o teste, basta publicar a ação clicando Publish Zap.

No exemplo, associamos os campos da seguinte forma:

{
 "recipientChannels":{"sms":"{NÚMERO DO CONTATO}"},
 "variables": {"name":"string"}
}

Pronto! Seguindo esses passos, você já consegue enviar dados do seu sistema ou provedor para uma uma automação de marketing do Zenvia Customer Cloud.