Vonage Server SDKs との統合
について Vonage CloudランタイムSDK を使用することができます。 プロバイダー を使えば、着信やメッセージなどを聞くことができます。また Vonage API を使ってアプリケーションを拡張することができます。例えば、発信電話をかけたり、SMSメッセージを送信することができます。これを行うには、選択したプログラミング言語で Vonage Server SDK を使用できます。Vonage Cloud Runtimeでデバッグまたはデプロイする場合、以下の認証情報がアプリケーションの環境で利用可能です:
- APIキー
VCR_API_ACCOUNT_ID) - APIシークレット
VCR_API_ACCOUNT_SECRET) - アプリケーションID
VCR_API_APPLICATION_ID) - アプリケーション秘密鍵
VCR_PRIVATE_KEY)
上記の認証情報と VonageサーバーSDK を使用すると、Vonage APIへのAPIコールを行うことができるクライアント・オブジェクトを作成することができます。例えば、Node Server SDKを使用します:
import { Vonage } from '@vonage/server-sdk';
const vonage = new Vonage(
{
apiKey: process.env.VCR_API_ACCOUNT_ID,
apiSecret: process.env.VCR_API_ACCOUNT_SECRET,
applicationId: process.env.VCR_API_APPLICATION_ID,
privateKey: process.env.VCR_PRIVATE_KEY
}
);
さて、これは vonage オブジェクトは Vonage API へのリクエストに使用できます。
電話をかける
以下はNode Server SDKを使ってVonage Cloud Runtimeに電話をかける例です:
import { Vonage } from '@vonage/server-sdk';
const vonage = new Vonage(
{
applicationId: process.env.VCR_API_APPLICATION_ID,
privateKey: process.env.VCR_PRIVATE_KEY
}
);
const call = await vonage.voice.createOutboundCall({
to: [toNumber],
from: vonageNumber,
ncco: [
{
action: 'talk',
text: 'Hello from Vonage Cloud Runtime!'
},
]
});
Voice APIの使用方法については、以下を参照してください。 Voice API ドキュメント.
SMSメッセージを送信する
以下は、Vonage Cloud RuntimeでSMSを送信するためにNode Server SDKを使用する例です:
import { Vonage } from '@vonage/server-sdk';
const vonage = new Vonage(
{
applicationId: process.env.VCR_API_APPLICATION_ID,
privateKey: process.env.VCR_PRIVATE_KEY
}
);
await vonage.messages.send({
text: 'Hello from Vonage Cloud Runtime!',
messageType: 'text',
to: toNumber,
from: vonageNumber,
channel: 'sms'
});
Messages APIの使い方については Messages API ドキュメント.