문서 메뉴

문서 홈Atlas App Services

Twilio 서비스 [사용 중단됨]

이 페이지의 내용

  • 개요
  • 구성 매개변수
  • 서비스 조치
  • 수신 Webhooks
  • 구성
  • 요청 페이로드
  • 웹훅 함수 예시
  • Twilio 구성
  • 메시징 서비스 만들기
  • Twilio 프로젝트에 Webhook 추가

중요

타사 서비스 & 푸시 알림 사용 중단

App Services의 타사 서비스 및 푸시 알림은 함수에서 외부 종속성을 사용하는 HTTP 엔드포인트를 만들기 위해 더 이상 사용되지 않습니다.

웹훅은 동작에 대한 변경 없이 HTTPS 엔드포인트로 이름이 변경되었습니다. 기존 웹훅을 마이그레이션해야 합니다.

기존 서비스는 2024년 11월 1일까지 계속 운영됩니다.

타사 서비스 및 푸시 알림은 이제 더 이상 사용되지 않으므로 App Services UI에서 기본적으로 제거되었습니다. 기존 타사 서비스 또는 푸시 알림을 관리해야 하는 경우 다음을 수행하여 구성을 UI에 다시 추가할 수 있습니다.

  • 왼쪽 탐색의 Manage 섹션에서 App Settings를 클릭합니다.

  • Temporarily Re-Enable 3rd Party Services 옆의 토글 스위치를 활성화한 다음 변경 사항을 저장합니다.

Twilio는 웹 및 모바일 앱에 메시징, 음성 및 채팅 서비스를 제공합니다. Atlas App Services Twilio 서비스는 Twilio의 프로그래밍 가능 SMS 서비스를 애플리케이션에 통합할 수 있도록 지원합니다.

참고

App Services와 함께 Twilio를 사용하려면 Twilio Twilio Phone Number 계정과 연결된 메시징 서비스에 이(가) 등록되어 있어야 합니다.Numbers Twilio 대시보드의 페이지에서 또는 Twilio의 Programmable SMS Quickstart 에 따라 새 번호를 만들 수 있습니다. 가이드.

Twilio 서비스 인터페이스를 만들 때 다음 매개변수에 대한 값을 제공해야 합니다.

매개변수
설명
Service Name
config.name
이 Twilio 서비스 인터페이스의 이름입니다. 이는 애플리케이션의 다른 모든 서비스 인터페이스와 구별되어야 합니다.
Twilio Account SID
config.sid
Twilio 계정의 고유 식별자입니다. 이 값은 Twilio 계정 대시보드에서 찾을 수 있습니다.
Twilio Authorization Token
secret_config.auth_token
사용자가 Twilio 계정의 소유자임을 증명하는 Twilio 권한 부여 토큰을 저장하는 Secret 의 이름입니다. You can find this value on your Twilio account dashboard.

App Services의 Twilio 서비스는 함수 와 SDK에서 사용할 수 있는 다음 조치를 제공합니다.

서비스 조치 사용에 대한 지침은 서비스 조치 호출을 참조하세요.

참고

Twilio Webhooks를 엔드포인트로 변환

Twilio 서비스 웹훅은 사용자 지정 HTTPS 엔드포인트를 위해 더 이상 사용되지 않습니다. 기존 Twilio 웹훅을 엔드포인트로 마이그레이션하는 방법을 알아보려면 웹훅 을 HTTPS 엔드포인트로 변환을 참조하세요.

Twilio 서비스용 수신 웹훅을 사용하면 앱에서 수신 문자 메시지를 처리할 수 있습니다. 수신 웹훅을 생성한 후에는 이를 Twilio 메시징 서비스에 추가하여 해당 서비스에 대해 수신 메시지를 처리할 수 있습니다.

구성 값
설명
Webhook Name
이름

필수입니다. 웹훅의 이름입니다.

참고

Twilio 서비스 인터페이스에서 수신되는 각 웹훅은 고유한 이름을 가져야 합니다.

Respond With Result
respond_result

필수입니다. true 인 경우 App Services는 웹훅 함수의 반환 값을 응답 본문의 Twilio로 보냅니다.

참고

Twilio는 웹훅 응답의 본문이 포함된 문자 메시지를 초기 메시지를 보낸 전화번호로 자동으로 보냅니다.

Run Webhook As
run_as_user_id
run_as_user_id_script_source

선택 사항. 웹훅이 호출될 때 웹훅 함수를 실행하는 App Services 사용자 의 ID입니다.

App Services는 수신 웹훅 함수에 payload 문서를 첫 번째 인수로 자동으로 전달합니다. Twilio 서비스 수신 웹훅에서 payload 객체는 수신 SMS 메시지를 나타내며 다음과 같은 형식을 갖습니다.

{
"From": "<Sender's Phone Number>",
"To": "<Receiver's Phone Number>",
"Body": "<SMS Body>"
}
필드
설명
From
다음을 164포함하는 문자열입니다 . -formatted 수신 문자 메시지를 보낸 전화번호입니다.
To
Body
수신 문자 메시지의 내용이 포함된 문자열입니다.

예제

전화번호 (555)867-5309 에서 "Hello! How are you?" 메시지와 함께 Twilio 전화번호 (805)716-6646 로 전송된 문자 메시지는 다음 payload 문서로 표시됩니다.

{
"From": "+15558675309",
"To": "+18057166646",
"Body": "Hello! How are you?"
}

다음 웹훅 함수는 MongoDB collection의 Twilio 전화번호로 전송된 문자 메시지를 저장하고 텍스트를 보낸 전화번호로 문자 메시지 응답을 보냅니다.

exports = async function(payload, response) {
// const { To, From, Body } = payload;
const mongodb = context.services.get("mongodb-atlas");
const texts = mongodb.db("demo").collection("texts");
try {
// Save the text message body, to number, and from number
const { insertedId } = await texts.insertOne(payload);
// Send the user a confirmation text message
response.setBody(`Saved your text message with _id: ${insertedId}`);
} catch (error) {
// Send the user an error notification text message
response.setBody(`Failed to save your text message: ${error}`);
}
}
  1. Twilio 에 로그인 .

  2. Twilio 프로젝트의 왼쪽 탐색 메뉴에서 Programmable SMS 를 클릭합니다.

  3. SMS > Messaging Services를 클릭합니다.

  4. Create new Messaging Service를 클릭합니다.

  5. Friendly NameUse Case을(를) 입력합니다.

  6. 클릭 Create

  1. Twilio 프로젝트의 왼쪽 탐색 메뉴에서 Programmable SMS 를 클릭합니다.

  2. SMS > Messaging Services를 클릭합니다.

  3. 사용하려는 메시징 서비스를 클릭합니다.

  4. 메시징 서비스 구성 페이지에서 PROCESS INBOUND MESSAGES 상자를 선택합니다.

  5. Request URL 상자에 수신 웹훅 URL을 입력합니다.

  6. Save를 클릭합니다.

이제 앱이 Twilio의 SMS 메시징 서비스와 통합되었습니다. Twilio 전화번호로 메시지를 보내 앱의 수신 웹훅을 호출합니다.

← http.head()