Plivo (Pré-visualização)
O Plivo permite enviar e receber SMS e chamadas de voz globalmente para empresas de todos os tamanhos.
Este conector está disponível nos seguintes produtos e regiões:
| Serviço | Class | Regiões |
|---|---|---|
| Estúdio Copiloto | Premium | Todas as regiões do Power Automatic , exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicações Lógicas | Standard | Todas as regiões do Logic Apps , exceto as seguintes: - Regiões do Azure Government - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Aplicações Power | Premium | Todas as regiões do Power Apps , exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Automatize o poder | Premium | Todas as regiões do Power Automatic , exceto as seguintes: - Governo dos EUA (CCG) - 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 | |
|---|---|
| Editora | Plivo Inc |
| Sítio Web | https://www.plivo.com/ |
| Política de privacidade | https://www.plivo.com/legal/privacy/ |
A criar uma ligação
O conector suporta os seguintes tipos de autenticação:
| Predefinição | 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.
Esta conexão não é compartilhável. Se o aplicativo avançado 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 (de caracteres) | O nome de usuário para esta api. | Verdade |
| Token de autenticação | securestring | A senha para esta api. | Verdade |
Limites de Limitação
| Name | Chamadas | Período de Renovação |
|---|---|---|
| Chamadas de API por conexão | 100 | 60 segundos |
Ações
| Enviar SMS |
Esta operação é usada para enviar uma mensagem de texto. |
| Fazer uma chamada |
Esta operação é usada para fazer uma chamada. |
| Listar todas as mensagens |
Esta operação devolve uma lista de todas as mensagens associadas à sua conta Plivo. |
| Receber mensagem |
Esta operação é usada para buscar os detalhes de uma mensagem, dado o ID da mensagem. |
Enviar SMS
Esta operação é usada para enviar uma mensagem de texto.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
De
|
src | True | string |
Número plivo a partir 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. |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
API ID
|
api_id | string |
ID exclusivo da solicitação de API. |
|
Resposta
|
message | string |
Resposta da mensagem enviada. |
|
Mensagem UUID
|
message_uuid | array of string |
ID exclusivo da mensagem. |
Fazer uma chamada
Esta operação é usada para fazer uma chamada.
Parâmetros
| Name | Chave | Necessá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 para ligar. |
|
URL de resposta
|
answer_url | True | string |
URL a ser chamado quando a chamada é feita. |
|
Método de resposta
|
answer_method | string |
Método HTTP (GET/POST) que deve ser usado para chamar a URL de resposta. |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
API ID
|
api_id | string |
ID exclusivo da solicitação de API. |
|
Resposta
|
message | string |
Resposta obtida quando a chamada foi feita. |
|
Ligue para UUID
|
request_uuid | string |
ID exclusivo da chamada. |
Listar todas as mensagens
Esta operação devolve uma lista de todas as mensagens associadas à sua conta Plivo.
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
API ID
|
api_id | string |
ID exclusivo da solicitação de API. |
|
Limite
|
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. |
|
Compensação
|
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 a partir 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/falha). |
|
Data e Hora
|
objects.message_time | string |
Carimbo de data/hora no qual a mensagem foi enviada ou recebida (aaaa-MM-dd HH:mm:ss UTC). |
|
Tipo de mensagem
|
objects.message_type | string |
Tipo de mensagem. |
|
Mensagem UUID
|
objects.message_uuid | string |
ID exclusivo 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. |
|
Montante Total
|
objects.total_amount | string |
Valor cobrado pela mensagem. |
|
Tarifa
|
objects.total_rate | string |
Taxa por unidade da mensagem. |
|
Units
|
objects.units | integer |
Número de unidades em que a mensagem foi dividida. |
Receber mensagem
Esta operação é usada para buscar os detalhes de uma mensagem, dado o ID da mensagem.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Mensagem UUID
|
message_uuid | True | string |
UUID da mensagem para a qual os detalhes precisam ser buscados. |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
API ID
|
api_id | string |
ID exclusivo 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 a partir 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/falha). |
|
Data e Hora
|
message_time | string |
Carimbo de data/hora no qual a mensagem foi enviada ou recebida (aaaa-MM-dd HH:mm:ss UTC). |
|
Tipo de mensagem
|
message_type | string |
Tipo de mensagem. |
|
Mensagem UUID
|
message_uuid | string |
ID exclusivo 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. |
|
Montante Total
|
total_amount | string |
Valor cobrado pela mensagem. |
|
Tarifa
|
total_rate | string |
Taxa por unidade da mensagem. |
|
Units
|
units | integer |
Número de unidades em que a mensagem foi dividida. |