Integração Constant Contact e Zenvia (via Zapier)

1. Criação de uma nova integração 

Para criar um novo Zap, na tela inicial do Zapier clique em Zaps. Você será direcionado para a seção em que todas as integrações da conta estão listadas. Para criar uma nova, clique no botão + Create localizado no canto superior direito da tela e selecione a opção New Zap.

Ao selecionar a opção, a tela do editor da integração será exibida:

No centro da parte superior da tela, clique em Untitled Zap e, depois, em Rename para renomear o zap responsável pela integração. 

2. Configuração do Gatilho e das Ações 

O gatilho é a porta de entrada da integração, recebendo dados dos leads enviados a partir da Constant Contact. Para configurá-lo, clique dentro do quadrado de nome Trigger e, na modal de seleção de aplicação, selecione a opção Webhooks. Ao clicar com o botão esquerdo novamente no primeiro quadrado do fluxo presente no editor, uma modal de configuração do webhook será exibida à direita da tela. Em geral, a configuração de um gatilho ou ação possui três passos: Setup, Configure e Test. O Trigger event deste webhook deve ser do tipo Catch Hook.

Na seção Test, está disponível a URL do webhook. Essa é a informação que precisa ser copiada e configurada no lugar de origem do envio das informações para o Zapier - em um workflow visual da Constant Contact, por exemplo.

Observação: em alguns dos passos seguintes, pode ser necessário a configuração de valores dinâmicos, ou seja, variáveis que dependem das informações de lead que são recebidas no webhook. Uma forma de gerar valores que possam ser utilizados na configuração de tais variáveis é enviar dados para a URL do webhook recém criado através do preenchimento de formulário em uma Landing Page da Constant Contact, por exemplo. Após o preenchimento, clique no botão Test trigger para que os Zapier realize uma escuta dos dados que foram recebidos.

O próximo passo é criar a ação responsável pelo  disparo da mensagem no whatsapp através da plataforma Zenvia. Para isso, clique sobre o segundo quadrado de nome Action. 

A mesma modal de seleção de aplicação para ser utilizada nesta tarefa será exibida. Nela, selecione novamente a opção Webhooks.

Para configurar esta tarefa, selecione o action event chamado Custom request.

Na seção de configuração em si, as configurações da requisição precisam ser feitas. O método utilizado deve ser o POST e a URL https://api.zenvia.com/v2/channels/whatsapp/messages. No campo Data, é necessário colar o seguinte modelo de body e ajustar as respectivas informações no conteúdo da requisição:

{
    "from": "<fromNumber>",
    "to": "<mobilePhoneNumber>",
    "contents": [
    {
    "type": "template",
    "templateId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "fields": {
                "nome_cliente": "<firstName> <lastName>"
              }
    }
    ]
}

• from: o número celular que está configurado para a realização de disparos de mensagem no Whatsapp.
• to: o número celular da pessoa que irá receber a mensagem. Este valor é variável.
• templateId: o ID do template de mensagem presente na Zenvia. Mais informações sobre como templates pra Whatsapp na Zenvia estão disponíveis neste artigo.
• fields: os valores que devem ser preenchidos nas variáveis presentes no template que está sendo utilizado - um ou mais campos. No exemplo abaixo, o template configurado possui somente o campo “nome_cliente”.

Por fim, as configurações de Headers devem ser implementadas como no seguinte exemplo:

A propriedade X-API-TOKEN é referente ao token de autorização (que pode ser encontrado dentro da plataforma da Zenvia).

Na sequência, para criar os caminhos de sucesso e de erro de acordo com resultado da requisição, selecione o ícone dos três pontos dentro da ação recém criada e selecione Add error handler.

A tarefa seguinte faz parte do caminho Error. Clique novamente em Action e selecione Google Sheets. O action event escolhido deve ser Create Spreadsheet Row e no campo Account uma conta do Google Sheets deve ser conectada. Caso não exista uma até o momento, é possível realizar uma nova conexão.

Conexão realizada, uma planilha precisa ser criada no Google Drive da conta que foi conectada, para que o mapeamento das informações que serão registradas possa ser realizado. Neste exemplo, foi criado um arquivo de nome “[Zenvia] Registro de erros”, contendo as seguintes colunas:

A seção de configuração da planilha deve ficar da seguinte forma:

As tarefas seguintes fazem parte do caminho Success. Para criar a primeira tarefa, clique no sinal de +, presente logo abaixo do campo verde. Na modal de seleção de aplicação, escolha Webhooks by Zapier.

Em Setup, selecione o action event Custom Request. Na seção Configure, o método deve ser GET e a URL utilizada https://api.zenvia.com/v2/templates/<templateId> - o templateId deve ser o mesmo utilizado na primeira ação criada, a de envio de template. Esta requisição não precisa de corpo da requisição.

Por último, as configurações de Headers devem ser implementadas:

A última ação a ser criada também é do tipo Webhooks bt Zapier e de action event Custom Request. Trata-se da ação responsável por salvar um evento de logCall diretamente na vida do lead da Constant Contact.

Nas configurações, o método utilizado deve ser o POST e a URL https://api.sharpspring.com/pubapi/v1?accountID=XXXXXXXXXX&secretKey=XXXXXXXXXX. Mais informações sobre como encontrar as informações da API Pública estão disponíveis neste artigo.

No campo Data, é necessário colar o seguinte modelo de body e ajustar as respectivas informações no conteúdo da requisição:

{
  "method": "logCalls",
  "params": {
    "objects": [
      {
        "userID": "<userId>",
        "leadID": "<leadId>",
        "direction": "outgoing",
        "callResult": "answered",
        "callNotes": "Mensagem {{message_name}} enviada às {{updateTimestamp}}",
        "createTimestamp": "{{updateTimestamp}}"
      }
    ]
  },
  "id": "123"
}

As propriedades userID, leadID, callNotes e createTimestamp possuem valores variáveis. Já as propriedades direction, callResult e id possuem valores fixos.

Na seção de Headers, as seguintes configurações devem ser implementadas:

Ao final, a integração deve possui a seguinte estrutura:

Um ponto a se notar é que tanto o gatilho quanto as ações podem ser renomeadas. Para isso, basta clicar nos respectivos ícones de três pontos e selecionar a opção Rename em cada um dos quadrados.