Utiliza la API de SendPulse en los flujos
El creador de chatbots de SendPulse incluye el elemento Solicitud API, que ayuda a enviar y recibir datos de sistemas externos e internos. Esto amplía tus opciones más allá de los escenarios estándar, incluyendo la creación de nuevos objetos o el envío de mensajes a través de la API.
En este artículo, hablaremos sobre cómo autorizar y enviar solicitudes a SendPulse a través de la API.
Autoriza solicitudes
Autoriza tus solicitudes para confirmar tu identidad y permitir que tu chatbot acceda a las funciones de SendPulse a través de la API.
Copia las credenciales de tu cuenta de SendPulse
Ve a Configuración > API. Copia tu ID y Secret. Las utilizarás para obtener un token y crear variables de chatbot.
Crea variables del chatbot
Crea variables globales en tu chatbot para guardar tus datos y de autorización.
Para añadir una variable global, ve a tu chatbot > Configuraciones > Variables del bot, y haz clic en Crear variable.
Añade las siguientes variables para poder obtener un token:
$access_token |
String | Almacena el token de acceso actual devuelto por la API de SendPulse después de la Autorización. Úsalo en el encabezado de autorización de tus solicitudes.
En el campo Valor, ingresa |
$access_token_expiration |
DateTime | Almacena la fecha y la hora en que el token actual deja de ser válido.
En el campo Valor, ingresa |
$SP_API_ID |
String | Se utiliza para obtener un token.
En el campo Valor, ingresa el |
$SP_API_SECRET |
String | Se utiliza con client_id para autorización.
En el campo Valor, ingresa el |
Obtén un token de acceso
Cada solicitud a la API de SendPulse requiere un token o clave de acceso. Puedes obtener este token a través del elemento Solicitud API en el flujo de tu chatbot.
Arrastra el elemento de Solicitud API al área de trabajo y selecciona el tipo de solicitud POST para enviarlo a https://api.sendpulse.com/oauth/access_token.
En el campo Cuerpo de la solicitud, añade JSON:
{
"grant_type":"client_credentials",
"client_id":"{{$SP_API_ID}}",
"client_secret":"{{$SP_API_SECRET}}"
}Más información sobre la autorización en la API REST del servicio SendPulse.
Haz clic en Probar solicitud. Si tu solicitud se realiza correctamente, recibirás un cuerpo de respuesta con datos que debes guardar.
Los tokens son válidos durante 1 hora y no requieren una nueva solicitud para cada ejecución del flujo.
Guarda el token en las variables de tu chatbot
Usa el elemento Acción: Establecer variable para guardar tu token. Selecciona la variable global $access_token y añade el valor {{$['access_token']}} del elemento anterior como JSONPath.
Sigue los mismos pasos para la variable global $access_token_expiration. Debido a que tu token es válido durante 1 hora, puedes utilizar esta variable antes de cada solicitud para decidir si necesitas un nuevo token o si puedes utilizar el existente. Actualiza el valor según corresponda.
En Establecer valor de la variable, selecciona la casilla Insertar variable y selecciona Fecha de ejecución. Luego, selecciona la casilla Añadir desplazamiento de valor y establece + 59 minutos.
Utiliza la API de SendPulse
Una vez que hayas recibido y guardado el token en tu chatbot, podrás utilizarlo para realizar solicitudes a la API de SendPulse. Cada nueva solicitud de API debe incluir un encabezado de Autorización con tu token.
Puedes encontrar todos los métodos de solicitud disponibles en la API REST del servicio SendPulse.
Añade el elemento de Solicitud API al espacio de trabajo y configúralo.
| Método | Elige un método en función de tu objetivo. Por ejemplo, utiliza POST para enviar un mensaje a Telegram y GET para recuperar información. A continuación, añade la URL del método. |
| Encabezado | Añade la Autorización con el valor Bearer {{$access_token}}.
El token se obtendrá automáticamente de la variable. |
Al inicio del flujo, agrega el elemento Filtro: Valor de variable para confirmar que tu token no esté vacío y siga siendo válido. En la configuración, selecciona las dos variables globales y establece las siguientes condiciones:
$access_token |
Selecciona la condición no vacío. |
$access_token_expiration |
Selecciona la condición antes, selecciona la opción Insertar variables y establece la variable Fecha de ejecución. |
Por ejemplo, veamos cómo enviar un mensaje a otro contacto a través de Telegram. En el elemento de Solicitud API, selecciona el método POST y pega esta URL: https://api.sendpulse.com/telegram/contacts/send.
Haz clic en Añadir encabezado, luego escribe Autorización en el primer campo y Bearer {{$access_token}} en el siguiente.
Añade el cuerpo de la solicitud con los parámetros necesarios. Así es como puede verse:{
{
"contact_id": "string",
"message": {
"type": "photo",
"photo": "https://www.cdn.com/photo.png",
"caption": "string"
}
}
También puedes elegir una plantilla prediseñada en Chatbots > Plantillas > API.
Última actualización: 12.08.2025
o