Requisitos previos

Antes de comenzar, necesitarás:

Una cuenta de ClickSend
Una cuenta de HubSpot
HubSpot Operations Hub Professional o superior – Ver planes

Paso 1: Crear un disparador de flujo de trabajo

En HubSpot, ve a Automatización > Flujos de trabajo.
Haz clic en Crear flujo de trabajo.
Escoge Basado en contactos > Flujo de trabajo en blanco, ponle un nombre y luego haz clic en Siguiente.
Haz clic en Configurar disparadores, luego define cómo entran los contactos en el flujo de trabajo.
- Ejemplo: Usa un filtro como "El número de teléfono no contiene 'a'" para incluir todos los números de teléfono válidos.
Haz clic en Aplicar filtro, prueba los criterios si es necesario y luego haz clic en Guardar.

Paso 2: Crear una aplicación privada en HubSpot

En una nueva pestaña, ve a Ajustes > Integraciones > Aplicaciones privadas.
Haz clic en Crear una aplicación privada.
Establece el nombre y la descripción de la aplicación.
Selecciona los alcances necesarios (Objetos de CRM > Contactos – acceso de lectura).
Haz clic en Crear aplicación, luego copia el Token de acceso para más tarde.

Paso 3: Añadir la acción de SMS en tu flujo de trabajo

De vuelta en el editor del flujo de trabajo, haz clic en el botón + para añadir una acción.
Escoge Código personalizado en la lista de acciones.
En la sección Secretos:
1. Haz clic en Escoger un secreto > Añadir secreto
2. Añade los siguientes secretos:
  - HPKEY – El token de tu aplicación privada de HubSpot
  - CSUSERNAME – Tu nombre de usuario de ClickSend (del panel de control)
  - CSKEY – Tu clave de API de ClickSend

Paso 4: Añadir y personalizar el código

Elimina el bloqueo de código existente.
Asegúrate de que HubSpot Client v3 esté seleccionado.
Copia y pega el siguiente 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 = `Hola ${firstName}, este es un mensaje de prueba de HubSpot.`; // Personalizar según sea necesario

    const data = JSON.stringify({
      messages: [{
        body: message,
        to: phone,
        from: "", // Opcional: añadir ID de remitente
        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. Haz clic en Guardar.

Prueba tu flujo de trabajo (opcional)

Haz clic en Probar en el flujo de trabajo.
Selecciona un contacto con un número de teléfono y ejecuta la prueba.
Si tiene éxito, verás "SUCCESS" en la salida.

Paso 5: Revisar y publicar

Haz clic en Revisar y publicar.
Revisar las opciones de inscripción, anulación de inscripción y plazos.
Haz clic en Activar para activar el flujo de trabajo.

Hecho

Tu flujo de trabajo ahora está activo y enviará un SMS a través de ClickSend cada vez que un contacto cumpla con tus condiciones del disparador.

Para obtener ayuda con la resolución de problemas, [ponte en contacto con nuestro equipo de asistencia.]

Guía de integración: HubSpot