Pré-requisitos

Antes de começar, você precisará de:

Uma conta ClickSend
Uma conta da HubSpot
HubSpot Operations Hub Professional ou superior – Ver planos

Passo 1: Criar um acionador de fluxo de trabalho

Na HubSpot, vá para Automação > Fluxos de trabalho.
Clique em Criar fluxo de trabalho.
Escolha Baseado em contato > Fluxo de trabalho em branco, nomeie-o e clique em Próximo.
Clique em Definir acionadores e, em seguida, defina como os contatos entram no fluxo de trabalho.
- Exemplo: Use um filtro como "O número de telefone não contém 'a'" para incluir todos os números de telefone válidos.
Clique em Aplicar filtro, teste os critérios se necessário e, em seguida, clique em Salvar.

Passo 2: Criar um aplicativo privado na HubSpot

Em uma nova aba, vá para Configurações > Integrações > Aplicativos privados.
Clique em Criar um aplicativo privado.
Defina o nome e a descrição do aplicativo.
Selecione os escopos necessários (Objetos de CRM > Contatos – acesso de leitura).
Clique em Criar aplicativo e copie a Ficha de acesso para usar mais tarde.

Passo 3: Adicionar a ação de SMS no seu fluxo de trabalho

De volta ao editor de fluxo de trabalho, clique no botão + para adicionar uma ação.
Escolha Código personalizado na lista de ações.
Na seção de Segredos:
1. Clique em Escolher um segredo > Adicionar segredo
2. Adicione os seguintes segredos:
  - HPKEY – Sua Ficha de aplicativo privado da HubSpot
  - CSUSERNAME – Seu nome de usuário do ClickSend (do painel)
  - CSKEY – Sua chave de API do ClickSend

Passo 4: Adicionar e personalizar o código

Remova o bloco de código existente.
Certifique-se de que o HubSpot Client v3 esteja selecionado.
Copie e cole o seguinte código:

const hubspot = require('@hubspot/api-client');
var axios = require('axios');

exports.main = async (event, callback) => {
  try {
    const username = process.env.CSUSERNAME;
    const key = process.env.CSKEY;
    const hubspotClient = new hubspot.Client({ accessToken: process.env.HPKEY });

    const result = Buffer.from(`${username}:${key}`).toString('base64');
    const contact = await hubspotClient.crm.contacts.basicApi.getById(
      event.object.objectId,
      ['phone', 'firstname', 'lastname']
    );

    const phone = contact.body.properties.phone;
    const firstName = contact.body.properties.firstname || '';
    const lastName = contact.body.properties.lastname || '';
    const message = `Olá ${firstName}, esta é uma mensagem de teste da HubSpot.`; // Personalize conforme necessário

    const data = JSON.stringify({
      messages: [{
        body: message,
        to: phone,
        from: "", // Opcional: adicionar ID do remetente
        source: "Hubspot"
      }]
    });

    const config = {
      method: 'post',
      url: 'https://rest.clicksend.com/v3/sms/send',
      headers: { 
        'Content-Type': 'application/json',
        'Authorization': `Basic ${result}`
      },
      data: data
    };

    await axios(config);
  } catch (err) {
    console.error(err);
    throw err;
  }

  callback({
    outputFields: {
      email: event.inputFields['email'],
      phone: event.inputFields['phone'],
    },
  });
};

4. Clique em Salvar.

Testar o seu fluxo de trabalho (opcional)

Clique em Testar no fluxo de trabalho.
Selecione um contato com um número de telefone e execute o teste.
Se for bem-sucedido, você verá "SUCCESS" na saída.

Passo 5: Revisar e publicar

Clique em Revisar e publicar.
Revise as opções de inscrição, cancelamento de inscrição e agendamento.
Clique em Ligar para ativar o fluxo de trabalho.

Pronto!

Seu fluxo de trabalho agora está ativo e enviará um SMS via ClickSend cada vez que um contato atender às suas condições do acionador.

Para ajuda com a solução de problemas, [entre em contato com a nossa equipe de suporte.]

Guia de integração: HubSpot