Docs Menu
Docs Home
/ /
Atlas App Services
/ /

Twilio 서비스 [사용 중단됨]

이 페이지의 내용

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

중요

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

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

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

기존 서비스는,9월까지 30 계속2025 작동합니다.

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

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

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

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

  • 아웃바운드 문자 메시지를 보내려면 send() 조치를 사용합니다.

  • 수신 문자 메시지를 처리하다 하고 선택적으로 응답하려면 수신 웹훅을 생성 하고 Twilio 메시징 서비스에 추가합니다. 예시 는 이 페이지의 수신 웹훅 섹션을 참조하세요.

참고

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

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

<Service Name>/config.json
{
"name": "<Service Name>",
"type": "twilio",
"config": {
"sid": <Twilio Account SID>
},
"secret_config": {
"auth_token": "<Secret Name>"
}
}
Parameter
설명
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 메시징 서비스에 추가하여 해당 서비스에 대해 수신 메시지를 처리할 수 있습니다.

Twilio 수신 웹훅을 만들때 다음 형식의 구성 파일 을 제공해야 합니다.

{
"name": <string>,
"respond_result": <boolean>,
"run_as_user_id": <string>,
"run_as_user_id_script_source": <string>,
}
구성 값
설명
Webhook Name
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입니다.

실행 사용자를 구성하는 방법에는 세 가지가 있습니다.

  • System실행 사용자는 시스템 사용자 로, MongoDB CRUD 및 애그리게이션 API에 대한 전체 액세스 을 가지며 모든 규칙 및 스키마 유효성 검사 를 우회합니다.

  • User Id: 함수를 실행할 특정 애플리케이션 사용자를 선택합니다.

  • Script: 실행 사용자의 id 를 반환하는 함수 를 정의합니다.

run_as_user_id 에 사용자 ID를 직접 지정하거나 웹훅 페이로드를 허용하고 run_as_user_id_script_source 에 사용자 ID를 반환하는 문자열화된 Atlas Function 를 제공할 수 있습니다. 특정 사용자 ID 또는 사용자 ID로 확인되는 함수를 지정하지 않으면 App Services 는 MongoDB CRUD 및 애그리게이션 API에 대한 전체 액세스 이 있는 시스템 사용자 로 웹훅 함수를 실행하고 모든 규칙 및 스키마 유효성 검사 를 우회합니다.

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

{
"From": "<Sender's Phone Number>",
"To": "<Receiver's Phone Number>",
"Body": "<SMS Body>"
}
필드
설명
From
string 164 형식의 수신 문자 메시지를 보낸 전화번호입니다.
To
string 164형식의 수신 문자 메시지가 전송된 Twilio 메시징 서비스와 연결된 전화번호입니다.
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()