하나의 받은편지함으로 모든 채널에 답하기

목표: 고객이 어떤 앱에서 글을 보내든 모든 메시지가 한곳에 도착하고, 그곳에서 답하는 호출은 하나입니다. 다섯 단계이고, 각 단계는 요청 하나입니다.

1. 받은편지함 계정 만들기

curl -X POST https://makehybrid.com/inbox/v1/account \
  -H "X-API-KEY: $MAKEHYBRID_KEY"

조직마다 한 번만 하면 됩니다. 다시 호출해도 같은 계정이 돌아오므로, 배포할 때마다 실행해도 안전합니다.

2. 채널 추가하기

curl -X POST https://makehybrid.com/inbox/v1/inboxes \
  -H "X-API-KEY: $MAKEHYBRID_KEY" -H "content-type: application/json" \
  -d '{"name":"Website","channel":{"type":"web_widget","website_url":"https://acme.com"}}'

curl -X POST https://makehybrid.com/inbox/v1/inboxes \
  -H "X-API-KEY: $MAKEHYBRID_KEY" -H "content-type: application/json" \
  -d '{"name":"Telegram","channel":{"type":"telegram","bot_token":"123456:ABC…"}}'

웹사이트 채팅은 </body> 앞에 붙여 넣을 스니펫을 돌려주며, 스니펫은 내 도메인에서 로드됩니다. Instagram과 TikTok은 로그인 링크로, Facebook Messenger는 페이지 관리자가 여는 링크로, LINE, SMS, WhatsApp은 해당 플랫폼 자체의 인증 정보로 추가합니다. 자세한 방법은 레퍼런스에 있습니다.

3. 새 메시지 받기

curl -X POST https://makehybrid.com/inbox/v1/webhooks/endpoints \
  -H "X-API-KEY: $MAKEHYBRID_KEY" -H "content-type: application/json" \
  -d '{"url":"https://acme.com/hooks/inbox","events":["inbox.message_created"]}'

돌려받은 시크릿은 보관하세요. 모든 전송은 이 시크릿으로 서명되어 x-mh-signature 헤더에 담기며, 같은 이벤트가 반복해서 오는 것은 정상입니다.

4. 고객이 쓴 곳에서 답장하기

curl -X POST https://makehybrid.com/inbox/v1/conversations/$CONVERSATION_ID/messages \
  -H "X-API-KEY: $MAKEHYBRID_KEY" -H "content-type: application/json" \
  -d '{"content":"Thanks, we are on it.","message_type":"outgoing"}'

답장은 그 대화의 채널로 나갑니다. "private": true를 더하면 팀에게만 보이는 메모가 됩니다.

5. 해결 처리하기

curl -X POST https://makehybrid.com/inbox/v1/conversations/$CONVERSATION_ID/toggle_status \
  -H "X-API-KEY: $MAKEHYBRID_KEY" -H "content-type: application/json" \
  -d '{"status":"resolved"}'

해결된 대화는 고객이 글을 보내면 저절로 다시 열립니다.

자주 묻는 질문