Mateflow는 세 가지 방법으로 커뮤니티를 다른 도구와 연결합니다. 연결된 앱(Slack, Discord, Zapier), 자체 서버로 보내는 웹훅, 개발자용 Open API입니다. 세 가지 모두 관리 페이지 한 곳, 관리자 → 설정 → 통합에 있습니다.
사용 가능한 사람: 소유자와 관리자. · 위치: 웹(관리 콘솔). · 플랜: 웹훅, API 액세스, 일일 API 요청 한도는 플랫폼 플랜에 따라 다릅니다.
관리 콘솔에서 통합 찾기
관리자 → 설정 → 통합으로 이동합니다. 페이지 이름은 연동 및 API이며 탭이 네 개 있습니다.
| 탭 | 하는 일 |
|---|---|
| 연동 | 연결된 앱에서 Slack, Discord, Zapier를 연결합니다 |
| 웹훅 | 커뮤니티 이벤트를 자체 엔드포인트로 보냅니다 |
| API 접근 | API 키를 만들고 폐기하며, 개발자 문서를 엽니다 |
| 전송 로그 | Mateflow가 웹훅, 앱, 자동화 규칙으로 보낸 모든 요청을 확인합니다 |
Slack, Discord, Zapier 연결하기
연결된 앱은 새 멤버, 게시물, 결제 같은 커뮤니티 이벤트를 다른 서비스로 보냅니다.
- Slack: Incoming Webhook URL을 통해 채널에 메시지를 게시합니다.
- Discord: Discord 웹훅 URL을 통해 채널에 메시지를 게시합니다. 메시지만 보내며, 멤버나 역할은 동기화하지 않습니다.
- Zapier: 이벤트를 Zapier Catch Hook으로 보내므로, Zap이 이를 수천 개의 다른 앱으로 전달할 수 있습니다.
연결하려면 연동 탭을 열고 Slack 연결, Discord 연결, Zapier 연결 중 하나를 클릭합니다. 해당 서비스의 웹훅 URL을 붙여 넣고, 전송할 이벤트를 선택하고, 필요하면 서명 시크릿 (선택) 항목을 추가한 다음 연결을 클릭합니다. 그런 다음 테스트 이벤트 보내기를 클릭해 메시지가 도착하는지 확인합니다.
연결된 카드에는 어떤 이벤트를 보내고 있는지 표시됩니다. 카드 메뉴에서 설정 편집, 테스트 이벤트 보내기, 연결 해제를 사용할 수 있습니다.
웹훅으로 자체 서버에 이벤트 보내기
웹훅은 선택한 이벤트가 발생할 때마다 직접 관리하는 엔드포인트로 HTTPS 요청을 보냅니다. 예를 들어 멤버 가입, 멤버 액세스 그룹 추가, 게시물 생성, 결제 수신 같은 이벤트입니다. 각 웹훅에는 고유한 이벤트, 선택 사항인 서명 시크릿, 활성 스위치가 있습니다. 웹훅 사용 여부와 만들 수 있는 개수는 플랫폼 플랜에 따라 다릅니다. 웹훅 설정하기를 참고하세요.
Open API로 직접 통합 만들기
Open API를 사용하면 개발자가 자신의 코드에서 커뮤니티 데이터를 읽고 쓸 수 있습니다. 게시물, 스페이스, 멤버를 읽고, 게시물을 만들고, 미디어를 업로드하고, 사람을 초대할 수 있습니다. 각 API 키는 하나의 커뮤니티에 속하며, 키를 만들 때 권한(스코프)을 선택합니다. API 키는 크리에이터 대시보드(app.mateflow.com)에서 관리하지 않습니다. 크리에이터 대시보드의 커뮤니티 개요 페이지에는 대신 이 관리 페이지로 가는 링크가 있습니다.
API로 보낸 초대에는 액세스 그룹을 포함할 수 있으며, 초대받은 사람이 수락하면 해당 액세스 그룹을 받습니다. 액세스 그룹의 작동 방식을 참고하세요.
전체 API 참조 문서는 mateflow.com/developers에 있습니다. API 접근 탭에서 문서 열기를 클릭해 이동하고, 링크를 개발자에게 보내세요. 개발자는 커뮤니티 계정이 없어도 됩니다. API 키 만들기를 참고하세요.
전송 로그에서 발신 요청 확인하기
전송 로그 탭에는 웹훅, 연결된 앱, Trigger webhook을 사용하는 자동화 규칙이 보낸 발신 요청이 나열됩니다. 이벤트 유형, 결과, 날짜로 필터링하고, 상세 보기를 클릭하면 전체 요청과 응답을 볼 수 있습니다. 전송 로그는 30일 동안 보관됩니다. 실패한 웹훅 전송은 자동으로 재시도되며, 직접 다시 보내는 버튼은 없습니다.
API 키로 보낸 요청은 여기에 기록되지 않습니다. 대신 API 접근 탭에 각 키의 마지막 사용 날짜가 표시됩니다.
관련 문서
이 가이드가 도움이 되었나요?