Prerequisiti

Prima di iniziare, avrai bisogno di:

Un account ClickSend
Un account HubSpot
HubSpot Operations Hub Professional o superiore – Visualizza i piani

Passaggio 1: Creare un trigger del flusso di lavoro

In HubSpot, andare su Automazione > Flussi di lavoro.
Cliccare su Crea flusso di lavoro.
Scegliere Basato sui contatti > Flusso di lavoro vuoto, assegnare un nome, quindi cliccare su Avanti.
Cliccare su Imposta trigger, quindi definire in che modo i contatti entrano nel flusso di lavoro.
- Esempio: utilizzare un filtro come "Il numero di telefono non contiene 'a'" per includere tutti i numeri di telefono validi.
Cliccare su Applica filtro, testare i criteri se necessario, quindi cliccare su Salva.

Passaggio 2: Creare un'app privata in HubSpot

In una nuova scheda, andare su Impostazioni > Integrazioni > App private.
Cliccare su Crea un'app privata.
Impostare il nome e la descrizione dell'app.
Selezionare gli ambiti necessari (Oggetti CRM > Contatti – accesso in lettura).
Cliccare su Crea app, quindi copiare il token di accesso per un momento successivo.

Passaggio 3: Aggiungere l'azione SMS nel flusso di lavoro

Di nuovo nell'editor del flusso di lavoro, cliccare sul pulsante + per aggiungere un'azione.
Scegliere Codice personalizzato dall'elenco delle azioni.
Nella sezione Segreti:
1. Cliccare su Scegli un segreto > Aggiungi segreto
2. Aggiungere i seguenti segreti:
  - HPKEY – Il token dell'app privata di HubSpot
  - CSUSERNAME – L'username ClickSend (dal pannello di controllo)
  - CSKEY – La chiave API ClickSend

Passaggio 4: Aggiungere e personalizzare il codice

Rimuovere il blocco di codice esistente.
Assicurarsi che sia selezionato HubSpot Client v3.
Copiare e incollare il seguente codice:

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 = `Ciao ${firstName}, questo è un messaggio di prova da HubSpot.`; // Personalizzare come necessario

    const data = JSON.stringify({
      messages: [{
        body: message,
        to: phone,
        from: "", // Opzionale: aggiungere l'ID del mittente
        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. Clicca su Salva.

Testare il flusso di lavoro (opzionale)

Cliccare su Test nel flusso di lavoro.
Selezionare un contatto con un numero di telefono ed eseguire il test.
Se l'operazione ha esito positivo, verrà visualizzato "SUCCESS" nell'output.

Passaggio 5: Rivedere e pubblicare

Cliccare su Rivedi e pubblica.
Rivedere le opzioni di iscrizione, annullamento dell'iscrizione e tempistiche.
Cliccare su Attiva per attivare il flusso di lavoro.

Fatto!

Il flusso di lavoro è ora attivo e invierà un SMS tramite ClickSend ogni volta che un contatto soddisfa le condizioni del trigger.

Per ricevere assistenza nella risoluzione dei problemi, [contattare il nostro team di assistenza].

Guida all'integrazione: HubSpot