Twilio 서비스 [사용 중단됨]
중요
타사 서비스 & 푸시 알림 사용 중단
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 서비스 인터페이스를 만들 때 다음 매개변수에 대한 값을 제공해야 합니다.
{ "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에서 사용할 수 있는 다음 조치를 제공합니다.
서비스 조치 사용에 대한 지침은 서비스 조치 호출을 참조하세요.
작업 | 설명 |
---|---|
지정된 전화번호로 문자 메시지를 전송합니다. |
수신 Webhooks
참고
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 | 필수입니다. 참고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 | 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}`); } }
Twilio 구성
메시징 서비스 만들기
Twilio 에 로그인 .
Twilio 프로젝트의 왼쪽 탐색 메뉴에서 Programmable SMS 를 클릭합니다.
SMS > Messaging Services를 클릭합니다.
Create new Messaging Service를 클릭합니다.
Friendly Name 및 Use Case을(를) 입력합니다.
클릭 Create
Twilio 프로젝트에 Webhook 추가
Twilio 프로젝트의 왼쪽 탐색 메뉴에서 Programmable SMS 를 클릭합니다.
SMS > Messaging Services를 클릭합니다.
사용하려는 메시징 서비스를 클릭합니다.
메시징 서비스 구성 페이지에서 PROCESS INBOUND MESSAGES 상자를 선택합니다.
Request URL 상자에 수신 웹훅 URL을 입력합니다.
Save를 클릭합니다.
이제 앱이 Twilio의 SMS 메시징 서비스와 통합되었습니다. Twilio 전화번호로 메시지를 보내 앱의 수신 웹훅을 호출합니다.