
MessageBird로 메시지 보내기
Made by MessageBird
MessageBird Conversations API를 사용하여 메시지와 알림을 보냅니다.
이 확장 프로그램의 작동 방식
이 확장 프로그램을 사용하면 MessageBird로 옴니채널 메시지(SMS, WhatsApp, Google의 Business Messages, Messenger, Telegram, Line, Viber 등)를 전송할 수 있습니다. 특정 Firestore 컬렉션에 문서를 추가하면 이 확장 프로그램이 MessageBird Conversations API를 사용하여 해당 문서를 메시지로 변환하고 전송 상태로 문서를 업데이트합니다.
db.collection('YOUR_DOCUMENT_COLLECTION').add({ channelId: 'YOUR_CHANNEL_ID', type: 'text', content: { text: 'YOUR_MESSAGE_CONTENT' }, to: 'RECIPIENT_OF_THE_MESSAGE', });
참고: Conversations API 문서에서 지원되는 메시지 유형 및 필수 콘텐츠 필드의 전체 목록을 찾아볼 수 있습니다.
추가 설정
이 확장 프로그램을 설치하기 전에 먼저 Firebase 프로젝트에 다음 Firebase 서비스를 설정합니다.
- 메시지 문서를 저장하기 위해 Cloud Firestore를 설정합니다.
- 문서의 단계에 따라 Cloud Firestore 데이터베이스를 만듭니다. 이 확장 프로그램을 설치하려면 MessageBird 계정과 MessageBird API 액세스 키가 있어야 합니다. 또한 메시지를 보낼 때 채널을 지정해야 하므로 메시지를 보내는 데 사용할 적절한 채널(SMS 채널, WhatsApp 채널, Facebook Messenger 채널, Telegram 채널 등)도 만들어야 합니다.
단계별 MessageBird 계정 설정
- MessageBird 페이지에서 MessageBird 계정을 만들고 메시지가 표시되면 \'API\' 경로를 선택합니다.
- 계정이 생성되면 대시보드 또는 개발자 설정 페이지에서 API 키를 볼 수 있습니다.
채널 페이지에서 사용하려는 채널을 다음과 같이 설정할 수 있습니다.
- SMS의 경우 발신 번호를 획득해야 합니다.
- WhatsApp의 경우 WhatsApp 설치 마법사에 따라 비즈니스용 WhatsApp 계정을 만들어야 합니다. 세션 외 WhatsApp 메시지를 보내려면 WhatsApp 메시지 템플릿을 만들어야 할 수도 있습니다.
- 다른 채널의 경우 채널 페이지의 안내를 따르세요.
참고: MessageBird에는 실제 메시지를 보내지 않고 API 호출을 할 수 있는 테스트 모드도 있습니다. 테스트 용도로 사용하여 개발 중 추가 비용을 방지할 수 있습니다.
결제
이 확장 프로그램은 관련 요금이 청구될 수 있는 다음 Firebase 서비스를 사용합니다.
- Cloud Firestore
- Cloud Functions
이 확장 프로그램은 다음 타사 서비스도 사용합니다.
- MessageBird 결제(가격 책정 정보)
이러한 서비스 사용으로 인한 관련 비용은 사용자가 부담해야 합니다.
Firebase 참고사항
이 확장 프로그램을 설치하려면 Firebase 프로젝트에서 사용한 만큼만 지불하는 Blaze 요금제를 이용해야 합니다. 사용한 리소스에 대해서만 요금이 청구됩니다. 대부분의 Firebase 서비스는 소량 사용을 위한 무료 등급을 제공합니다. Firebase 요금 자세히 알아보기
이 확장 프로그램을 설치하거나 재구성할 때 소액(일반적으로 $0.10 미만)이 청구됩니다. 자세한 내용은 Firebase 가격 책정의 Cloud Functions를 참조하세요.
확장 프로그램 설치 방법
Firebase CLI 사용
Firebase CLI를 사용해 확장 프로그램을 설치하고 관리할 수도 있습니다.
1단계: 다음 npm 명령어를 실행하여 CLI를 설치하거나 최신 CLI 버전으로 업데이트합니다.
npm install -g firebase-tools작동하지 않는 경우 Firebase CLI 참조를 살펴보거나 npm 권한을 변경하세요.
2단계: 새 Firebase 프로젝트 디렉터리를 설정하거나 기존 디렉터리로 이동합니다.
3단계: 다음을 실행하여 이 확장 프로그램을 확장 프로그램 매니페스트에 추가합니다.
firebase ext:install messagebird/firestore-messagebird-send-msg --local --project=projectId_or_alias
4단계(선택사항): Firebase 에뮬레이터 도구 모음으로 이 확장 프로그램을 로컬에서 테스트합니다.
firebase emulators:start
5단계: 매니페스트의 확장 프로그램을 프로젝트에 배포합니다.
firebase deploy --only extensions --project=projectId_or_alias