Introducción
Twilio es una plataforma en la nube que proporciona las herramientas e infraestructura para que las empresas se comuniquen con sus clientes de manera eficiente y efectiva. Este conector aprovecha el poder de la API REST de Twilio para consumir endpoints específicos y ofrecer una solución de comunicación integral.
El conector de Twilio para Bizagi está disponible para su descarga en Bizagi Connectors Xchange. Con este conector, usted puede integrar sus procesos de Bizagi con su cuenta y servicios de Twilio. Para obtener más información sobre las capacidades de este conector, visite la plataforma Xchange.
|
Este conector se desarrolló en base al contenido y la información de la API proporcionada por Twilio. Bizagi y sus subsidiarias no ofrecen garantías respecto al contenido o errores derivados de las llamadas al servicio de API. Bizagi y sus subsidiarias no son responsables de cualquier pérdida, costo o daño que surja del uso de la API de Twilio. |
Antes de comenzar
Para probar y usar este conector, usted necesitará:
1.Bizagi Studio instalado.
2.El conector instalado, ya sea a través del Connectors Xchange o mediante instalación manual según se describe en el artículo Instalar y administrar conectores.
3.Una cuenta en Twilio.
Cómo configurar Twilio
1.Visite la página de registro de Twilio y complete la información para crear una cuenta de prueba.
2.Una vez que haya completado las validaciones necesarias e ingresado la información requerida por Twilio para finalizar la configuración, aparecerá el siguiente Dashboard.
3.En el Dashboard, haga clic en el menú desplegable de Admin y luego seleccione la opción Administración de cuentas.
A continuación, en el menú lateral a la izquierda de su pantalla, vaya a Administrar cuenta > Configuración general. Aquí encontrará su SID de cuenta. Haga clic en el enlace Llaves de API y Tokens para ver el Token de autorización correspondiente.
4.Desplácese hacia abajo en la ventana que aparece después de hacer clic en el enlace y localice la sección Credenciales en vivo. En esta sección, verá nuevamente su SID de cuenta, junto con el Token de autorización, que está oculto por razones de seguridad. Haga clic en el ícono del ojo para revelar el token y copie ambos valores (el ID de cuenta y el Token de autorización) en un bloc de notas o archivo de texto al que pueda acceder fácilmente, ya que necesitará estos valores al configurar el conector en Bizagi.
5.Vaya a Números de teléfono de Twilio y solicite un número de teléfono. El número debe ser de los Estados Unidos (actualmente, los números de Colombia no admiten el envío de SMS) y debe verificar que el número tenga capacidades de SMS y llamadas, sin estar restringido solo a hacer llamadas locales en EE.UU. Si el número no tiene estas funcionalidades, puede solicitar otro. Guarde el número de teléfono, ya que es necesario para realizar acciones del conector.
6.Para enviar y realizar llamadas a Colombia, necesita habilitar permisos para el país. Desde el Dashboard principal, vaya a Mensajería, luego Configuración, y finalmente Permisos Geo. Encuentre los países que desea habilitar, que están categorizados por continente, y luego haga clic en el botón Guardar permisos geo en la parte inferior para aplicar sus cambios.
7.Debido a las restricciones de la cuenta de prueba, necesita verificar los números a los que enviará SMS o realizará llamadas. Para hacer esto, vaya a Números verificados de Twilio y agregue un nuevo número. Recibirá un SMS con un código de verificación. Una vez hecho esto, puede enviar SMS al número agregado. Para ver la lista de números verificados asociados con su cuenta, navegue desde el Dashboard principal a # Números de Teléfono > Administrar > IDs de Llamadas Verificadas.
Configuración del conector
Para configurar el conector, especialmente sus parámetros de autenticación, siga los pasos descritos en la sección Configuración de Conectores del artículo Instalar y administrar conectores.
Para esta configuración, use los siguientes parámetros de autenticación:
•from: El número de Twilio utilizado para enviar mensajes y llamadas; este parámetro es global y utilizado por todas las acciones.
•voice_url: La URL con el XML que todas las llamadas deben ejecutar; este parámetro es global y utilizado por todas las acciones.
•accountId: El SID de la cuenta de Twilio obtenido anteriormente en la sección de Credenciales en Vivo.
•authToken: El Token de autenticación API de Twilio obtenido anteriormente en la sección de Credenciales en Vivo.
Uso del conector
Este conector incluye un conjunto de acciones que le permiten utilizar los servicios de la API de Twilio y aprovechar sus capacidades.
Para una guía general sobre la configuración de un conector, consulte el artículo Utilizar conectores.
Al utilizar este conector, tenga en cuenta los siguientes detalles para las acciones disponibles.
Acciones disponibles
Enviar SMS
Esta acción envía un SMS utilizando Twilio.
Para configurar sus entradas, considere las siguientes descripciones:
•from (String - Requerido): El número desde el cual se enviará el SMS. Este es el número que Twilio proporciona al usuario. Si el usuario en Bizagi establece el número en la propiedad global "from" en la configuración del conector, no es necesario especificar el número de Twilio nuevamente aquí. Si el usuario especifica el "from" en la entrada de esta acción, este valor tendrá prioridad sobre el global. Este parámetro debe ser un String en su modelo Bizagi.
•to (String - Requerido): El número al que se enviará el SMS (destinatario del SMS). Este parámetro debe ser un String en su modelo Bizagi.
•body (String - Requerido): Mensaje a enviar. Este parámetro debe ser un String en su modelo Bizagi.
Para configurar las salidas de esta acción, mapee el objeto de salida a la entidad correspondiente en Bizagi, asegurándose de mapear correctamente los atributos de la entidad.
Para configurar sus salidas, considere las siguientes descripciones:
•sid (String): ID que identifica el SMS creado.
•date_created (DateTime): Fecha de creación del SMS en el formato "Mar, 15 May 2018 16:02:24 +0000".
•date_updated (DateTime): Fecha de actualización de la información del SMS en el formato "Mar, 15 May 2018 16:02:24 +0000".
•date_sent (DateTime): Fecha de envío del SMS en el formato "Mar, 15 May 2018 16:02:24 +0000". Esta fecha es inicialmente nula cuando el mensaje de texto se crea (está en cola y aún no se envía al usuario).
•account_sid (String): ID de la cuenta que envía el SMS. Es el mismo ID que está configurado en los parámetros de autenticación del conector.
•to (String): Teléfono que recibe el SMS (destinatario del SMS). Formato: + [código de país] [número] (sin corchetes).
•from (String): Número de teléfono que envía el SMS. Este es el número que Twilio asigna al usuario. Formato: + [código de país] [número] (sin corchetes).
•body (String): Mensaje que se envía en el SMS.
•status (String o entero): Estado del mensaje. Ejemplo: "queued" cuando el mensaje se crea correctamente y está esperando ser enviado, "delivered" cuando el mensaje ya ha sido enviado al usuario.
•api_version (String): Versión de la API utilizada para enviar el SMS. El valor es: "2010-04-01".
•price (flotante): Precio de enviar el SMS. Los precios están disponibles una vez que el mensaje se envía (no disponible cuando está en el estado "queued").
•price_unit (String): Unidad de precio. Ejemplo: "USD" para dólares.
•error_code (String): Código de error en caso de que ocurra un error.
•error_message (String): Mensaje de error en caso de que ocurra un error.
•uri (String): URL donde se puede consultar la información del SMS. Por ejemplo: se puede ver el estado, si ya fue "delivered".
Para obtener más información sobre este método, consulte la documentación oficial de Twilio.
Obtener información del SMS
Esta acción consulta la información de un SMS dado su SID.
Para configurar sus entradas, considere las siguientes descripciones:
•sid (String - Requerido): ID del SMS del cual desea consultar la información. Este parámetro debe ser un String en su modelo Bizagi.
Para configurar las salidas de esta acción, mapee el objeto de salida a la entidad correspondiente en Bizagi, asegurándose de mapear correctamente los atributos de la entidad.
•sid (String): ID que identifica el SMS creado.
•date_created (DateTime): Fecha de creación del SMS en el formato "Mar, 15 May 2018 16:02:24 +0000".
•date_updated (DateTime): Fecha de actualización de la información del SMS en el formato "Mar, 15 May 2018 16:02:24 +0000".
•date_sent (DateTime): Fecha de envío del SMS en el formato "Mar, 15 May 2018 16:02:24 +0000". Esta fecha es inicialmente nula cuando el mensaje de texto se acaba de crear (está en cola y aún no se ha enviado al usuario).
•account_sid (String): ID de la cuenta desde la cual se envía el SMS. Es el mismo ID que está configurado en los parámetros de autenticación del conector.
•to (String): Número de teléfono que recibe el SMS (destinatario del SMS). Formato: + [código de país] [número] (sin corchetes).
•from (String): Número de teléfono que envía el SMS. Este es el número que Twilio asigna al usuario. Formato: + [código de país] [número] (sin corchetes).
•body (String): Mensaje que se envía en el SMS.
•status (String o entero): Estado del mensaje. Ejemplo: "queued" cuando el mensaje se crea correctamente y está esperando ser enviado, "delivered" cuando el mensaje ya ha sido enviado al usuario.
•api_version (String): Versión de la API utilizada para enviar el SMS. El valor es: "2010-04-01".
•price (flotante): Precio de enviar el SMS. El precio está disponible una vez que el mensaje se envía (no está disponible cuando está en el estado "queued").
•price_unit (String): Unidad de precio. Ejemplo: "USD" para dólares.
•error_code (String): Código de error en caso de que ocurra un error.
•error_message (String): Mensaje de error en caso de que ocurra un error.
•uri (String): URL donde se puede consultar la información del SMS. Por ejemplo, se puede ver el estado si ya ha sido "delivered".
Para obtener más información sobre este método, consulte la documentación oficial de Twilio.
Obtener Todos los SMS
Esta acción consulta y devuelve todos los mensajes enviados.
Esta acción no tiene entradas.
Para configurar las salidas de esta acción, mapee el objeto de salida a la entidad correspondiente en Bizagi, asegurándose de mapear correctamente los atributos de la entidad.
Esta acción devuelve una lista de objetos de mensajes con las siguientes descripciones:
•account_sid (String): ID de la cuenta desde la cual se envía el SMS. Este es el mismo ID configurado en los parámetros de autenticación del conector.
•api_version (String): Versión de la API utilizada para enviar el SMS. El valor es: “2010-04-01”.
•body (String): El mensaje enviado en el SMS.
•date_created (DateTime): La fecha en que se creó el SMS en el formato “Mar, 15 May 2018 16:02:24 +0000”.
•date_sent (DateTime): La fecha en que se envió el SMS en el formato “Mar, 15 May 2018 16:02:24 +0000”. Esta fecha es inicialmente nula cuando el mensaje de texto se crea por primera vez (está en cola y aún no se ha enviado al usuario).
•date_updated (DateTime): La fecha en que se actualizó la información del SMS en el formato “Mar, 15 May 2018 16:02:24 +0000”.
•error_code (String): El código de error si ocurre un error.
•error_message (String): El mensaje de error si ocurre un error.
•from (String): El número de teléfono desde el cual se envía el SMS. Este es el número que Twilio asigna al usuario. Formato: +[código de país][número] (sin corchetes).
•price (float): El precio de enviar el SMS. El precio está disponible una vez que el mensaje se envía (no está disponible cuando está en el estado “queued”).
•price_unit (String): La unidad de precio. Ejemplo: “USD” para dólares.
•sid (String): El ID que identifica el SMS creado.
•status (String o entero): El estado del mensaje. Ejemplo: “queued” cuando el mensaje se crea correctamente y está esperando ser enviado, “delivered” cuando el mensaje ya ha sido enviado al usuario.
•to (String): El número de teléfono al cual se enviará el SMS (el destinatario del SMS). Formato: +[código de país][número] (sin corchetes).
•uri (String): La URL donde se puede consultar la información del SMS. Por ejemplo, se puede ver el estado si ya ha sido “delivered”.
Last Updated 9/26/2024 1:48:33 PM