Plivo (versión preliminar)
Plivo permite enviar y recibir llamadas SMS y voz globalmente para empresas de todos los tamaños.
Este conector está disponible en los siguientes productos y regiones:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Aplicaciones lógicas | Estándar | Todas las regiones de Logic Apps excepto las siguientes: - Regiones de Azure Government - Regiones de Azure China - Departamento de Defensa de EE. UU. (DoD) |
| Power Apps | Premium | Todas las regiones de Power Apps excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Power Automate | Premium | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Contacto | |
|---|---|
| URL | https://support.plivo.com/support/home |
| Metadatos del conector | |
|---|---|
| Publicador | Plivo Inc |
| Sitio web | https://www.plivo.com/ |
| Directiva de privacidad | https://www.plivo.com/legal/privacy/ |
Creación de una conexión
El conector admite los siguientes tipos de autenticación:
| Predeterminado | Parámetros para crear una conexión. | Todas las regiones | No se puede compartir |
Predeterminado
Aplicable: Todas las regiones
Parámetros para crear una conexión.
Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.
| Nombre | Tipo | Description | Obligatorio |
|---|---|---|---|
| Identificador de autenticación | cuerda / cadena | Nombre de usuario de esta API. | Cierto |
| Token de autenticación | securestring | Contraseña de esta API. | Cierto |
Limitaciones
| Nombre | Llamadas | Período de renovación |
|---|---|---|
| Llamadas API por conexión | 100 | 60 segundos |
Acciones
| Enumerar todos los mensajes |
Esta operación devuelve una lista de todos los mensajes asociados a su cuenta de Plivo. |
| Envío de SMS |
Esta operación se usa para enviar un mensaje de texto. |
| Obtener mensaje |
Esta operación se usa para capturar los detalles de un mensaje, dado el identificador del mensaje. |
| Realizar una llamada |
Esta operación se usa para realizar una llamada. |
Enumerar todos los mensajes
Esta operación devuelve una lista de todos los mensajes asociados a su cuenta de Plivo.
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Identificador de API
|
api_id | string |
Identificador único de la solicitud de API. |
|
Limit
|
meta.limit | integer |
Número máximo de mensajes en una sola página. |
|
Next
|
meta.next | string |
URI de la página siguiente de mensajes si existe. |
|
Desplazar
|
meta.offset | integer |
Número de mensajes antes de esta página. |
|
Anterior
|
meta.previous | string |
URI de la página anterior. |
|
Recuento total
|
meta.total_count | integer |
Número total de mensajes. |
|
Lista de mensajes
|
objects | array of object |
Detalles de todos los mensajes. |
|
Código de error
|
objects.error_code | string |
Código de error de entrega si el mensaje no se entrega. |
|
De
|
objects.from_number | string |
Número desde el que se envió el mensaje. |
|
Dirección del mensaje
|
objects.message_direction | string |
Dirección del mensaje (entrante o saliente). |
|
Estado de entrega de mensajes
|
objects.message_state | string |
Estado del mensaje (en cola, enviado, entregado o erróneo). |
|
Marca de tiempo
|
objects.message_time | string |
Marca de tiempo en la que se envió o recibió el mensaje (aaaa-MM-dd HH:mm:ss UTC). |
|
Tipo de mensaje
|
objects.message_type | string |
Tipo del mensaje. |
|
UUID del mensaje
|
objects.message_uuid | string |
Identificador único del mensaje. |
|
URI del mensaje
|
objects.resource_uri | string |
URI para obtener detalles de este único mensaje. |
|
Para
|
objects.to_number | string |
Número al que se envió el mensaje. |
|
Importe total
|
objects.total_amount | string |
Importe cargado por el mensaje. |
|
Tasa
|
objects.total_rate | string |
Tasa por unidad del mensaje. |
|
Unidades
|
objects.units | integer |
Número de unidades en las que se dividió el mensaje. |
Envío de SMS
Esta operación se usa para enviar un mensaje de texto.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
De
|
src | True | string |
Número plivo desde el que se va a enviar el mensaje. |
|
Para
|
dst | True | string |
Número de teléfono al que se va a enviar el mensaje. |
|
Message
|
text | True | string |
Texto del mensaje que se va a enviar. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Identificador de API
|
api_id | string |
Identificador único de la solicitud de API. |
|
Respuesta
|
message | string |
Respuesta del mensaje enviado. |
|
UUID del mensaje
|
message_uuid | array of string |
Identificador único del mensaje. |
Obtener mensaje
Esta operación se usa para capturar los detalles de un mensaje, dado el identificador del mensaje.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
UUID del mensaje
|
message_uuid | True | string |
UUID del mensaje para el que se deben capturar los detalles. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Identificador de API
|
api_id | string |
Identificador único de la solicitud de API. |
|
Código de error
|
error_code | string |
Código de error de entrega si el mensaje no se entrega. |
|
De
|
from_number | string |
Número desde el que se envió el mensaje. |
|
Dirección del mensaje
|
message_direction | string |
Dirección del mensaje (entrante o saliente). |
|
Estado de entrega de mensajes
|
message_state | string |
Estado del mensaje (en cola, enviado, entregado o erróneo). |
|
Marca de tiempo
|
message_time | string |
Marca de tiempo en la que se envió o recibió el mensaje (aaaa-MM-dd HH:mm:ss UTC). |
|
Tipo de mensaje
|
message_type | string |
Tipo del mensaje. |
|
UUID del mensaje
|
message_uuid | string |
Identificador único del mensaje. |
|
URI del mensaje
|
resource_uri | string |
URI para obtener detalles de este único mensaje. |
|
Para
|
to_number | string |
Número al que se envió el mensaje. |
|
Importe total
|
total_amount | string |
Importe cargado por el mensaje. |
|
Tasa
|
total_rate | string |
Tasa por unidad del mensaje. |
|
Unidades
|
units | integer |
Número de unidades en las que se dividió el mensaje. |
Realizar una llamada
Esta operación se usa para realizar una llamada.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
De
|
from | True | string |
Número plivo que se usará para realizar la llamada. |
|
Para
|
to | True | string |
Número de teléfono al que se va a llamar. |
|
Dirección URL de respuesta
|
answer_url | True | string |
Dirección URL a la que se llamará cuando se realiza la llamada. |
|
Answer (método)
|
answer_method | string |
Método HTTP (GET/POST) que se debe usar para llamar a la dirección URL de respuesta. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Identificador de API
|
api_id | string |
Identificador único de la solicitud de API. |
|
Respuesta
|
message | string |
Respuesta obtenida cuando se realizó la llamada. |
|
Llamar a UUID
|
request_uuid | string |
Identificador único de la llamada. |