Skip to content

Twilio

이 예제에서는 Twilio의 메시지 전송 API를 통해 사용자에게 SMS 및 MMS를 보낼 수 있도록 Braze 웹훅 채널을 구성합니다. 편의를 위해 대시보드에 Twilio 웹훅 템플릿이 포함되어 있습니다.

HTTP URL

웹훅 URL은 Twilio 대시보드에서 제공됩니다. 이 URL은 Twilio 계정 ID(TWILIO_ACCOUNT_SID)를 포함하고 있기 때문에 사용자의 Twilio 계정에 고유합니다.

Twilio 예제에서 웹훅 URL은 https://api.twilio.com/2010-04-01/Accounts/TWILIO_ACCOUNT_SID/Messages.json입니다. Twilio 콘솔의 Getting Started 섹션에서 이 URL을 찾을 수 있습니다.

Twilio_Console

요청 본문

Twilio API는 요청 본문이 URL 인코딩되어야 하므로, Braze 웹훅 작성기에서 요청 유형을 Raw Text로 변경하는 것부터 시작해야 합니다. 요청 본문에 필요한 매개변수는 To, From, 및 Body입니다.

다음 스크린샷은 각 사용자의 전화번호로 “Hello from Braze!”라는 본문의 SMS를 보내는 경우 요청이 어떻게 보일 수 있는지에 대한 예시입니다.

  • 타겟 오디언스의 각 고객 프로필에 유효한 전화번호가 있어야 합니다.
  • Twilio의 요청 형식을 충족하려면 메시지 콘텐츠에 url_param_escape Liquid 필터를 사용하세요. 이 필터는 문자열을 인코딩하여 모든 문자가 HTML 요청에서 허용되도록 합니다. 예를 들어, 전화번호 +12125551212의 더하기 문자(+)는 URL 인코딩된 데이터에서 금지되어 있으며 %2B12125551212로 변환됩니다.

Webhook Body

요청 헤더 및 메서드

Twilio는 두 개의 요청 헤더, 즉 요청 Content-Type과 HTTP 기본 인증 헤더를 요구합니다. 웹훅 작성기 옆에 있는 톱니바퀴 아이콘을 클릭한 다음 Add New Pair를 두 번 클릭하여 웹훅에 추가하세요.

헤더 이름 헤더 값
Content-Type application/x-www-form-urlencoded
Authorization Basic {{ 'TWILIO_ACCOUNT_SID:TWILIO_AUTH_TOKEN' | base64_encode }}

TWILIO_ACCOUNT_SID 및 TWILIO_AUTH_TOKEN을 Twilio 대시보드의 값으로 바꾸세요. 마지막으로, Twilio의 API 엔드포인트는 HTTP POST 요청을 기대하므로 HTTP Method 드롭다운에서 해당 옵션을 선택하세요.

Webhook Method

요청 미리보기

웹훅 작성기를 사용하여 무작위 사용자 또는 특정 자격 증명을 가진 사용자의 요청을 미리 보고, 요청이 올바르게 렌더링되는지 확인하세요.

Webhook Preview
New Stuff!