Plivo (versão prévia)
O Plivo permite enviar e receber sms e chamadas de voz globalmente para empresas de todos os tamanhos.
Esse conector está disponível nos seguintes produtos e regiões:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicativos Lógicos | Standard | Todas as regiões dos Aplicativos Lógicos , exceto as seguintes: – Regiões do Azure Governamental - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Power Apps | Premium | Todas as regiões do Power Apps , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Power Automate | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contato | |
|---|---|
| URL | https://support.plivo.com/support/home |
| Metadados do conector | |
|---|---|
| Publicador | Plivo Inc |
| Site da Web | https://www.plivo.com/ |
| Política de privacidade | https://www.plivo.com/legal/privacy/ |
Criando uma conexão
O conector dá suporte aos seguintes tipos de autenticação:
| Default | Parâmetros para criar conexão. | Todas as regiões | Não compartilhável |
Padrão
Aplicável: todas as regiões
Parâmetros para criar conexão.
Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.
| Nome | Tipo | Description | Obrigatório |
|---|---|---|---|
| ID de autenticação | cadeia | O nome de usuário desta api. | Verdade |
| Token de autenticação | secureString | A senha dessa api. | Verdade |
Limitações
| Nome | Chamadas | Período de renovação |
|---|---|---|
| Chamadas à API por conexão | 100 | 60 segundos |
Ações
| Enviar SMS |
Essa operação é usada para enviar uma mensagem de texto. |
| Fazer uma chamada |
Essa operação é usada para fazer uma chamada. |
| Listar todas as mensagens |
Esta operação retorna uma lista de todas as mensagens associadas à sua conta do Plivo. |
| Obter mensagem |
Essa operação é usada para buscar os detalhes de uma mensagem, considerando a ID da mensagem. |
Enviar SMS
Essa operação é usada para enviar uma mensagem de texto.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
De
|
src | True | string |
Número plivo do qual a mensagem deve ser enviada. |
|
Para
|
dst | True | string |
Número de telefone para o qual a mensagem deve ser enviada. |
|
Message
|
text | True | string |
Texto da mensagem a ser enviada. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
API ID
|
api_id | string |
ID exclusiva da solicitação de API. |
|
Resposta
|
message | string |
Resposta da mensagem enviada. |
|
UUID de mensagem
|
message_uuid | array of string |
ID exclusiva da mensagem. |
Fazer uma chamada
Essa operação é usada para fazer uma chamada.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
De
|
from | True | string |
Número plivo a ser usado para fazer a chamada. |
|
Para
|
to | True | string |
O número de telefone a ser chamado. |
|
URL de resposta
|
answer_url | True | string |
URL a ser chamada quando a chamada for feita. |
|
Método Answer
|
answer_method | string |
Método HTTP (GET/POST) que deve ser usado para chamar a URL de Resposta. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
API ID
|
api_id | string |
ID exclusiva da solicitação de API. |
|
Resposta
|
message | string |
Resposta obtida quando a chamada foi feita. |
|
Chamar UUID
|
request_uuid | string |
ID exclusiva da chamada. |
Listar todas as mensagens
Esta operação retorna uma lista de todas as mensagens associadas à sua conta do Plivo.
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
API ID
|
api_id | string |
ID exclusiva da solicitação de API. |
|
Limit
|
meta.limit | integer |
Número máximo de mensagens em uma única página. |
|
Next
|
meta.next | string |
URI da próxima página de mensagens, se existir. |
|
Offset
|
meta.offset | integer |
Número de mensagens antes desta página. |
|
Anterior
|
meta.previous | string |
URI da página anterior. |
|
Contagem total
|
meta.total_count | integer |
Número total de mensagens. |
|
Lista de Mensagens
|
objects | array of object |
Detalhes de todas as mensagens. |
|
Código de erro
|
objects.error_code | string |
Código de erro de entrega se a mensagem não for entregue. |
|
De
|
objects.from_number | string |
Número do qual a mensagem foi enviada. |
|
Direção da Mensagem
|
objects.message_direction | string |
Direção da mensagem (entrada/saída). |
|
Status de Entrega de Mensagens
|
objects.message_state | string |
Status da mensagem (enfileirada/enviada/entregue/com falha). |
|
Timestamp
|
objects.message_time | string |
Carimbo de data/hora no qual a mensagem foi enviada ou recebida (yyyyy-MM-dd HH:mm:ss UTC). |
|
Tipo de Mensagem
|
objects.message_type | string |
Tipo da mensagem. |
|
UUID de mensagem
|
objects.message_uuid | string |
ID exclusiva da mensagem. |
|
URI da mensagem
|
objects.resource_uri | string |
URI para obter detalhes desta única mensagem. |
|
Para
|
objects.to_number | string |
Número para o qual a mensagem foi enviada. |
|
Valor Total
|
objects.total_amount | string |
Valor cobrado pela mensagem. |
|
Rate
|
objects.total_rate | string |
Taxa por unidade da mensagem. |
|
Unidades
|
objects.units | integer |
Número de unidades em que a mensagem foi dividida. |
Obter mensagem
Essa operação é usada para buscar os detalhes de uma mensagem, considerando a ID da mensagem.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
UUID de mensagem
|
message_uuid | True | string |
UUID da mensagem para a qual os detalhes precisam ser buscados. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
API ID
|
api_id | string |
ID exclusiva da solicitação de API. |
|
Código de erro
|
error_code | string |
Código de erro de entrega se a mensagem não for entregue. |
|
De
|
from_number | string |
Número do qual a mensagem foi enviada. |
|
Direção da Mensagem
|
message_direction | string |
Direção da mensagem (entrada/saída). |
|
Status de Entrega de Mensagens
|
message_state | string |
Status da mensagem (enfileirada/enviada/entregue/com falha). |
|
Timestamp
|
message_time | string |
Carimbo de data/hora no qual a mensagem foi enviada ou recebida (yyyyy-MM-dd HH:mm:ss UTC). |
|
Tipo de Mensagem
|
message_type | string |
Tipo da mensagem. |
|
UUID de mensagem
|
message_uuid | string |
ID exclusiva da mensagem. |
|
URI da mensagem
|
resource_uri | string |
URI para obter detalhes desta única mensagem. |
|
Para
|
to_number | string |
Número para o qual a mensagem foi enviada. |
|
Valor Total
|
total_amount | string |
Valor cobrado pela mensagem. |
|
Rate
|
total_rate | string |
Taxa por unidade da mensagem. |
|
Unidades
|
units | integer |
Número de unidades em que a mensagem foi dividida. |