Prérequis

Avant de débuter, vous aurez besoin de :

Un compte ClickSend
Un compte HubSpot
HubSpot Operations Hub Professional ou supérieur – Voir les abonnements

Étape 1 : Créer un déclencheur de scénario

Dans HubSpot, allez dans Automatisation > Scénarios.
Cliquez sur Créer un scénario.
Choisissez Basé sur le contact > Scénario vide, donnez-lui un prénom, puis cliquez sur Suivant.
Cliquez sur Configurer les déclencheurs, puis définissez comment les contacts entrent dans le scénario.
- Exemple : Utilisez un filtre tel que "Le numéro de téléphone ne contient pas 'a'" pour inclure tous les numéros de téléphone valides.
Cliquez sur Appliquer le filtre, testez les critères si nécessaire, puis cliquez sur Sauvegarder.

Étape 2 : Créer une application privée dans HubSpot

Dans un nouvel onglet, allez dans Paramètres > Intégrations > Applications privées.
Cliquez sur Créer une application privée.
Définissez le prénom et la description de l'application.
Sélectionnez les portées nécessaires (Objets CRM > Contacts – accès en lecture).
Cliquez sur Créer l'application, puis copiez le jeton d'accès pour plus tard.

Étape 3 : Ajouter l'action de service de messagerie simple dans votre scénario

De retour dans l'éditeur de scénario, cliquez sur le bouton + pour ajouter une action.
Choisissez Code personnalisé dans la liste des actions.
Dans la section Secrets :
1. Cliquez sur Choisir un secret > Ajouter un secret
2. Ajoutez les secrets suivants :
  - HPKEY – Le jeton de votre application privée HubSpot
  - CSUSERNAME – Votre nom d'utilisateur ClickSend (depuis le tableau de bord)
  - CSKEY – Votre clé API ClickSend

Étape 4 : Ajouter et personnaliser le code

Retirez le blocage de code existant.
Assurez-vous que HubSpot Client v3 est sélectionné.
Copiez et collez le code suivant :

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 = `Hi ${firstName}, this is a test message from HubSpot.`; // Personnaliser selon les besoins

    const data = JSON.stringify({
      messages: [{
        body: message,
        to: phone,
        from: "", // Optionnelle : ajouter un identifiant d'expéditeur
        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. Cliquez sur Enregistrer.

Testez votre scénario (optionnelle)

Cliquez sur Tester dans le scénario.
Sélectionnez un contact avec un numéro de téléphone et lancez le test.
En cas de succès, vous verrez "SUCCESS" dans la sortie.

Étape 5 : Réviser et publier

Cliquez sur Réviser et publier.
Révisez les options d'inscription, de désinscription et de temporisation.
Cliquez sur Mettre en marche pour activer le scénario.

C'est fait !

Votre scénario est maintenant en ligne et va envoyer un service de messagerie simple via ClickSend chaque fois qu'un contact remplit vos conditions de déclenchement.

Pour obtenir de l'aide au dépannage, [contactez notre équipe support.]

Guide d'intégration : HubSpot