Vonage(미리 보기)
Vonage API 플랫폼을 사용하면 SMS, 음성 및 채팅을 비롯한 애플리케이션 컨텍스트 내에서 통신을 추가할 수 있습니다. 여기에서 Nexmo 계정에 등록합니다. https://www.vonage.com/
이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.
| 서비스 | 클래스 | Regions |
|---|---|---|
| Copilot Studio | Premium | 다음을 제외한 모든 Power Automate 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| 논리 앱 | 스탠다드 | 다음을 제외한 모든 Logic Apps 지역 : - Azure Government 지역 - Azure 중국 지역 - 미국 국방부(DoD) |
| Power Apps | Premium | 다음을 제외한 모든 Power Apps 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| Power Automate | Premium | 다음을 제외한 모든 Power Automate 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| 연락처 | |
|---|---|
| 이름 | Vonage 지원 |
| URL | https://www.vonage.co.uk/support |
| 전자 메일 | support@vonage.com |
| 커넥터 메타데이터 | |
|---|---|
| 게시자 | Vonage |
| 웹 사이트 | https://vonage.com |
| 개인 정보 취급 방침 | https://www.vonage.com/legal/privacy-policy |
| 카테고리 | Communication |
Vonage API 플랫폼을 사용하면 SMS, 음성 및 채팅을 비롯한 애플리케이션 컨텍스트 내에서 통신을 추가할 수 있습니다.
필수 조건
계속하려면 다음이 필요합니다.
- Vonage 계정, 에 등록 https://dashboard.nexmo.com/sign-up
자격 증명을 가져오는 방법
자격 증명을 얻으려면 에서 무료 Vonage 계정에 등록할 수 있습니다. https://dashboard.nexmo.com/sign-up
알려진 문제 및 제한 사항
이 커넥터는 현재 모든 Vonage 제품 및 API를 노출하지 않습니다.
제한 한도
| Name | 호출 | 갱신 기간 |
|---|---|---|
| 연결당 API 호출 | 100 | 60초 |
동작
| 숫자에 대한 기본 숫자 인사이트 정보를 제공합니다. |
숫자에 대한 기본 숫자 인사이트 정보를 제공합니다. |
| 숫자에 대한 표준 숫자 인사이트 정보를 제공합니다. |
숫자에 대한 표준 숫자 인사이트 정보를 제공합니다. |
| 지정된 채널에 메시지 보내기 |
메시지 보내기 |
| 확인 요청 |
Verify 요청을 사용하여 PIN을 생성하고 사용자에게 보냅니다. |
| 확인 확인 |
사용자로부터 받은 PIN이 확인 요청과 일치하는지 확인합니다. |
숫자에 대한 기본 숫자 인사이트 정보를 제공합니다.
숫자에 대한 기본 숫자 인사이트 정보를 제공합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
응답 형식
|
format | True | string |
응답 형식 |
|
API 키
|
api_key | True | string |
API 키 |
|
API 비밀
|
api_secret | True | string |
API 비밀 |
|
국내 또는 국제 형식으로 인사이트가 필요한 전화 번호
|
number | True | string |
국내 또는 국제 형식으로 인사이트가 필요한 전화 번호 |
|
ISO 3166-1 alpha-2 형식의 2자 국가 코드입니다. GB 또는 미국
|
country | True | string |
ISO 3166-1 alpha-2 형식의 2자 국가 코드입니다. GB 또는 미국 |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
status
|
status | integer | |
|
status_message
|
status_message | string | |
|
요청_아이디
|
request_id | string | |
|
international_format_number
|
international_format_number | string | |
|
national_format_number
|
national_format_number | string | |
|
country_code
|
country_code | string | |
|
country_code_iso3
|
country_code_iso3 | string | |
|
country_name
|
country_name | string | |
|
country_prefix
|
country_prefix | string |
숫자에 대한 표준 숫자 인사이트 정보를 제공합니다.
숫자에 대한 표준 숫자 인사이트 정보를 제공합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
응답 형식
|
format | True | string |
응답 형식 |
|
API 키
|
api_key | True | string |
API 키 |
|
API 비밀
|
api_secret | True | string |
API 비밀 |
|
국내 또는 국제 형식으로 인사이트가 필요한 전화 번호
|
number | True | string |
국내 또는 국제 형식으로 인사이트가 필요한 전화 번호 |
|
ISO 3166-1 alpha-2 형식의 2자 국가 코드입니다. GB 또는 미국
|
country | True | string |
ISO 3166-1 alpha-2 형식의 2자 국가 코드입니다. GB 또는 미국 |
|
응답에서 전화 번호 소유자 이름을 수신하려면 true로 설정
|
cnam | string |
응답에서 전화 번호 소유자 이름을 수신하려면 true로 설정 |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
status
|
status | integer | |
|
status_message
|
status_message | string | |
|
요청_아이디
|
request_id | string | |
|
international_format_number
|
international_format_number | string | |
|
national_format_number
|
national_format_number | string | |
|
country_code
|
country_code | string | |
|
country_code_iso3
|
country_code_iso3 | string | |
|
country_name
|
country_name | string | |
|
country_prefix
|
country_prefix | string | |
|
request_price
|
request_price | string | |
|
refund_price
|
refund_price | string | |
|
remaining_balance
|
remaining_balance | string | |
|
network_code
|
current_carrier.network_code | string | |
|
이름
|
current_carrier.name | string | |
|
country
|
current_carrier.country | string | |
|
network_type
|
current_carrier.network_type | string | |
|
network_code
|
original_carrier.network_code | string | |
|
이름
|
original_carrier.name | string | |
|
country
|
original_carrier.country | string | |
|
network_type
|
original_carrier.network_type | string | |
|
포팅
|
ported | string | |
|
caller_type
|
caller_identity.caller_type | string | |
|
caller_name
|
caller_identity.caller_name | string | |
|
first_name
|
caller_identity.first_name | string | |
|
last_name
|
caller_identity.last_name | string | |
|
caller_name
|
caller_name | string | |
|
last_name
|
last_name | string | |
|
first_name
|
first_name | string | |
|
caller_type
|
caller_type | string |
지정된 채널에 메시지 보내기
메시지 보내기
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
요청의 콘텐츠 형식
|
Content-Type | True | string |
콘텐츠 유형 (Content-Type) |
|
허용되는 날짜 유형
|
Accept | True | string |
Accept |
|
보낼 메시지의 유형입니다. 이 필드에 텍스트를 제공해야 합니다.
|
message_type | string |
보낼 메시지의 유형입니다. 이 필드에 텍스트를 제공해야 합니다. |
|
|
보낼 메시지의 텍스트입니다. 1000자로 제한됨
|
text | string |
보낼 메시지의 텍스트입니다. 1000자로 제한됨 |
|
|
E.164 형식의 메시지 받는 사람의 전화 번호
|
to | string |
E.164 형식의 메시지 받는 사람의 전화 번호 |
|
|
E.164 형식의 메시지 받는 사람의 전화 번호
|
from | string |
E.164 형식의 메시지 받는 사람의 전화 번호 |
|
|
보낼 채널입니다. 이 필드에 sms를 제공해야 합니다.
|
channel | string |
보낼 채널입니다. 이 필드에 sms를 제공해야 합니다. |
|
|
최대 40자의 클라이언트 참조
|
client_ref | string |
최대 40자의 클라이언트 참조 |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
message_uuid
|
message_uuid | string |
message_uuid |
확인 요청
Verify 요청을 사용하여 PIN을 생성하고 사용자에게 보냅니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
응답 형식
|
format | True | string |
응답 형식 |
|
계정 대시보드에서 API 키를 찾을 수 있습니다. https://dashboard.nexmo.com
|
api_key | True | string |
계정 대시보드에서 API 키를 찾을 수 있습니다. https://dashboard.nexmo.com |
|
대시보드에서 API 비밀을 찾을 수 있습니다. https://dashboard.nexmo.com
|
api_secret | True | string |
대시보드에서 API 비밀을 찾을 수 있습니다. https://dashboard.nexmo.com |
|
확인할 모바일 또는 유선 전화 번호입니다. 번호는 E.164 형식이어야 합니다.
|
number | True | string |
확인할 모바일 또는 유선 전화 번호입니다. 번호는 E.164 형식이어야 합니다. |
|
두 문자로 된 국가 코드를 지정하고 숫자의 서식을 지정합니다.
|
country | string |
두 문자로 된 국가 코드를 지정하고 숫자의 서식을 지정합니다. |
|
|
요청 SMS 본문을 개인 설정하기 위해 사용하는 18자 영숫자 문자열
|
brand | True | string |
요청 SMS 본문을 개인 설정하기 위해 사용하는 18자 영숫자 문자열 |
|
보낸 사람의 ID를 나타내는 11자 영숫자 문자열입니다.
|
sender_id | string |
보낸 사람의 ID를 나타내는 11자 영숫자 문자열입니다. |
|
|
확인 코드의 길이
|
code_length | integer |
확인 코드의 길이 |
|
|
확인 요청에 사용되는 언어 제어
|
lg | string |
확인 요청에 사용되는 언어 제어 |
|
|
생성된 확인 코드가 유효한 기간(초)입니다.
|
pin_expiry | integer |
생성된 확인 코드가 유효한 기간(초)입니다. |
|
|
확인 코드를 배달하려는 시도 사이의 대기 시간(초)
|
next_event_wait | integer |
확인 코드를 배달하려는 시도 사이의 대기 시간(초) |
|
|
사용자에게 PIN을 전달하는 미리 정의된 SMS 및 TTS 작업 시퀀스
|
workflow_id | integer |
사용자에게 PIN을 전달하는 미리 정의된 SMS 및 TTS 작업 시퀀스 |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
status
|
status | string | |
|
요청_아이디
|
request_id | string |
확인 확인
사용자로부터 받은 PIN이 확인 요청과 일치하는지 확인합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
응답 형식
|
format | True | string |
응답 형식 |
|
API 키
|
api_key | True | string |
API 키 |
|
API 비밀
|
api_secret | True | string |
API 비밀 |
|
확인 요청에 대한 응답에서 받은 request_id
|
request_id | True | string |
확인 요청에 대한 응답에서 받은 request_id |
|
사용자가 입력한 확인 코드
|
code | True | string |
사용자가 입력한 확인 코드 |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
요청_아이디
|
request_id | string | |
|
event_id
|
event_id | string | |
|
status
|
status | string | |
|
가격
|
price | string | |
|
currency
|
currency | string | |
|
estimated_price_messages_sent
|
estimated_price_messages_sent | string |