Saltar al contenido principal

Envío de SMS vía HubSpot

API de integración SMS para uso con la plataforma HubSpot.

Nota

Para usar la API, utiliza la funcionalidad WebHook:

Webhook URL   https://sms.witi.me/sms/hubspot_send_sms.aspx?api_key=API_KEY&template=TEMPLATE_ID
Método           POST
Entrada          JSON con datos de contacto (enviado por el WebHook registrado en HubSpot)
Respuesta          JSON con el resultado de la programación de envío

ParámetroDescripción
api_keyLa clave API se puede encontrar en el menú SMS > Configuración SMS.
templateID de la plantilla registrada en la plataforma Witime (menú SMS > Plantillas SMS).
rota[Opcional]
Si no se proporciona, se usa la ruta predeterminada
numero[Opcional]
Si no se proporciona, usa el parámetro mobilephone enviado por HubSpot

Ejemplo de Salida:

{
"Resultado": {
"CodigoResultado": 0,
"Mensagem": "Message processed successfully. Processed in 177ms.",
"Chave": "154d1c4d-2836-4913-10f8-084b20f3e9ze",
"Cobrado": true,
"ValorCobrado": 0.20
},
"Mensagens": [
{
"numero": "+5511987654321",
"mensagem": "test message 1",
"UniqueID": "31b2c48f-2ea9-4979-a9dd-cbfb927de18f",
"DataAgendamento": "2020-07-26 14:35:08",
"Custo": 0.2000,
"idDisparo": 25,
"Situacao": 1,
"MensagemSituacao": null,
"Codigo_cliente": "0000001",
"Rota": 228
}
],
"Saldo": 3220.6300
}

Plantillas

Para registrar plantillas SMS, ve al menú SMS > Plantillas SMS. Usa el campo Web ID en las llamadas de HubSpot.

Variables

Puedes usar variables proporcionadas por HubSpot en tus mensajes, como: $firstname$, $lastname$, $email$, $state$, entre otras. Para acceder a la lista completa de variables, ejecuta una prueba de WebHook en el mismo HubSpot para analizar las variables enviadas en el POST: