Plivo (wersja zapoznawcza)
Plivo umożliwia wysyłanie i odbieranie połączeń sms i głosowych globalnie dla firm o wszystkich rozmiarach.
Ten łącznik jest dostępny w następujących produktach i regionach:
| Usługa | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Wszystkie regiony usługi Power Automate z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Logic Apps | Standard | Wszystkie regiony usługi Logic Apps z wyjątkiem następujących: — Regiony platformy Azure Government — Regiony platformy Azure (Chiny) - Departament Obrony USA (DoD) |
| Power Apps | Premium | Wszystkie regiony usługi Power Apps z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Power Automate | Premium | Wszystkie regiony usługi Power Automate z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Kontakt | |
|---|---|
| adres URL | https://support.plivo.com/support/home |
| Metadane łącznika | |
|---|---|
| Publisher | Plivo Inc |
| Witryna internetowa | https://www.plivo.com/ |
| Zasady ochrony prywatności | https://www.plivo.com/legal/privacy/ |
Tworzenie połączenia
Łącznik obsługuje następujące typy uwierzytelniania:
| Wartość domyślna | Parametry tworzenia połączenia. | Wszystkie regiony | Nie można udostępniać |
Domyślny
Dotyczy: Wszystkie regiony
Parametry tworzenia połączenia.
Nie jest to możliwe do udostępnienia połączenie. Jeśli aplikacja Power App zostanie udostępniona innemu użytkownikowi, inny użytkownik zostanie poproszony o jawne utworzenie nowego połączenia.
| Name | Typ | Description | Wymagane |
|---|---|---|---|
| Identyfikator uwierzytelniania | ciąg | Nazwa użytkownika dla tego interfejsu API. | Prawda |
| Token uwierzytelniania | securestring | Hasło dla tego interfejsu API. | Prawda |
Limity ograniczania
| Nazwa | Wywołania | Okres odnowienia |
|---|---|---|
| Wywołania interfejsu API na połączenie | 100 | 60 sekund |
Akcje
| Nawiązywanie połączenia |
Ta operacja służy do wykonywania wywołania. |
| Pobieranie komunikatu |
Ta operacja służy do pobierania szczegółów komunikatu, biorąc pod uwagę identyfikator komunikatu. |
| Wyślij wiadomość SMS |
Ta operacja służy do wysyłania wiadomości SMS. |
| Wyświetlanie listy wszystkich komunikatów |
Ta operacja zwraca listę wszystkich komunikatów skojarzonych z kontem Plivo. |
Nawiązywanie połączenia
Ta operacja służy do wykonywania wywołania.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Źródło
|
from | True | string |
Numer Plivo, który ma być używany do wywołania. |
|
Do
|
to | True | string |
Numer telefonu do połączenia. |
|
Adres URL odpowiedzi
|
answer_url | True | string |
Adres URL, który ma być wywoływany po wywołaniu. |
|
Answer, metoda
|
answer_method | string |
Metoda HTTP (GET/POST), która powinna służyć do wywoływania adresu URL odpowiedzi. |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Identyfikator interfejsu API
|
api_id | string |
Unikatowy identyfikator żądania interfejsu API. |
|
Odpowiedź
|
message | string |
Odpowiedź uzyskana podczas wykonywania wywołania. |
|
Wywoływanie identyfikatora UUID
|
request_uuid | string |
Unikatowy identyfikator wywołania. |
Pobieranie komunikatu
Ta operacja służy do pobierania szczegółów komunikatu, biorąc pod uwagę identyfikator komunikatu.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator UUID komunikatu
|
message_uuid | True | string |
UUID komunikatu, dla którego należy pobrać szczegóły. |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Identyfikator interfejsu API
|
api_id | string |
Unikatowy identyfikator żądania interfejsu API. |
|
Kod błędu
|
error_code | string |
Kod błędu dostarczania, jeśli komunikat nie jest dostarczany. |
|
Źródło
|
from_number | string |
Numer, z którego wysłano wiadomość. |
|
Kierunek komunikatu
|
message_direction | string |
Kierunek komunikatu (ruch przychodzący/wychodzący). |
|
Stan dostarczania komunikatów
|
message_state | string |
Stan komunikatu (w kolejce/wysłane/dostarczone/nie powiodło się). |
|
Sygnatura czasowa
|
message_time | string |
Sygnatura czasowa, o której wiadomość została wysłana lub odebrana (rrrr-MM-dd HH:mm:ss UTC). |
|
Typ komunikatu
|
message_type | string |
Wpisz komunikat. |
|
Identyfikator UUID komunikatu
|
message_uuid | string |
Unikatowy identyfikator wiadomości. |
|
Identyfikator URI komunikatu
|
resource_uri | string |
Identyfikator URI, aby uzyskać szczegółowe informacje o tej pojedynczej wiadomości. |
|
Do
|
to_number | string |
Numer, do którego wysłano wiadomość. |
|
Łączna kwota
|
total_amount | string |
Kwota naliczona za komunikat. |
|
Rate
|
total_rate | string |
Szybkość na jednostkę komunikatu. |
|
Units
|
units | integer |
Liczba jednostek, na które wiadomość została podzielona. |
Wyślij wiadomość SMS
Ta operacja służy do wysyłania wiadomości SMS.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Źródło
|
src | True | string |
Numer Plivo, z którego ma zostać wysłana wiadomość. |
|
Do
|
dst | True | string |
Numer telefonu, do którego ma zostać wysłana wiadomość. |
|
Message
|
text | True | string |
Tekst wiadomości do wysłania. |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Identyfikator interfejsu API
|
api_id | string |
Unikatowy identyfikator żądania interfejsu API. |
|
Odpowiedź
|
message | string |
Odpowiedź wysłanej wiadomości. |
|
Identyfikator UUID komunikatu
|
message_uuid | array of string |
Unikatowy identyfikator wiadomości. |
Wyświetlanie listy wszystkich komunikatów
Ta operacja zwraca listę wszystkich komunikatów skojarzonych z kontem Plivo.
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Identyfikator interfejsu API
|
api_id | string |
Unikatowy identyfikator żądania interfejsu API. |
|
Ograniczenie
|
meta.limit | integer |
Maksymalna liczba komunikatów na jednej stronie. |
|
Next
|
meta.next | string |
Identyfikator URI następnej strony komunikatów, jeśli istnieje. |
|
Przesunięcie
|
meta.offset | integer |
Liczba komunikatów przed tą stroną. |
|
Wstecz
|
meta.previous | string |
Identyfikator URI poprzedniej strony. |
|
Łączna liczba
|
meta.total_count | integer |
Łączna liczba komunikatów. |
|
Lista wiadomości
|
objects | array of object |
Szczegóły wszystkich komunikatów. |
|
Kod błędu
|
objects.error_code | string |
Kod błędu dostarczania, jeśli komunikat nie jest dostarczany. |
|
Źródło
|
objects.from_number | string |
Numer, z którego wysłano wiadomość. |
|
Kierunek komunikatu
|
objects.message_direction | string |
Kierunek komunikatu (ruch przychodzący/wychodzący). |
|
Stan dostarczania komunikatów
|
objects.message_state | string |
Stan komunikatu (w kolejce/wysłane/dostarczone/nie powiodło się). |
|
Sygnatura czasowa
|
objects.message_time | string |
Sygnatura czasowa, o której wiadomość została wysłana lub odebrana (rrrr-MM-dd HH:mm:ss UTC). |
|
Typ komunikatu
|
objects.message_type | string |
Wpisz komunikat. |
|
Identyfikator UUID komunikatu
|
objects.message_uuid | string |
Unikatowy identyfikator wiadomości. |
|
Identyfikator URI komunikatu
|
objects.resource_uri | string |
Identyfikator URI, aby uzyskać szczegółowe informacje o tej pojedynczej wiadomości. |
|
Do
|
objects.to_number | string |
Numer, do którego wysłano wiadomość. |
|
Łączna kwota
|
objects.total_amount | string |
Kwota naliczona za komunikat. |
|
Rate
|
objects.total_rate | string |
Szybkość na jednostkę komunikatu. |
|
Units
|
objects.units | integer |
Liczba jednostek, na które wiadomość została podzielona. |