내 코드에서 ChatWoot에 답하기

팀은 이미 ChatWoot에서 고객에게 답하고 있습니다. 이 방법은 같은 ChatWoot에 내 코드에서 닿습니다. 받은편지함, 열려 있는 대화, 오간 내용, 내가 보내는 답까지. 받은편지함을 하나 더 만들 필요도, 무언가를 옮길 필요도 없습니다.

한 번만 연결하기

룸 페이지에서, 로그인한 상태로, ChatWoot 대시보드의 주소와 관리자의 액세스 토큰을 넣습니다. 연결하면 팀의 답변이 돌아오도록 웹훅 하나가 추가되고, 연결을 끊으면 제거됩니다. API는 이 둘을 받지 않습니다. POST /chatwoot/v1/connections/link는 넣을 페이지의 주소와 함께 403으로 답합니다.

무엇이 열려 있나

curl "https://makehybrid.com/chatwoot/v1/connections" \
  -H "X-API-KEY: $MAKEHYBRID_KEY"

curl "https://makehybrid.com/chatwoot/v1/connections/$CONNECTION_ID/conversations?status=open" \
  -H "X-API-KEY: $MAKEHYBRID_KEY"

각 대화에는 상대 연락처, 배정된 에이전트, 받은편지함, 마지막으로 움직인 시각이 담겨 있습니다. 메시지는 오래된 순으로 오며, 각각 어느 방향이었는지 나옵니다. incoming은 고객의 것, outgoing은 팀의 것입니다.

답하기, 메모하기, 해결하기

curl -X POST https://makehybrid.com/chatwoot/v1/connections/$CONNECTION_ID/conversations/$CONVERSATION_ID/messages \
  -H "X-API-KEY: $MAKEHYBRID_KEY" -H "Content-Type: application/json" \
  -d '{"content":"It went out this morning — here is the tracking link."}'

curl -X PATCH https://makehybrid.com/chatwoot/v1/connections/$CONNECTION_ID/conversations/$CONVERSATION_ID \
  -H "X-API-KEY: $MAKEHYBRID_KEY" -H "Content-Type: application/json" \
  -d '{"status":"resolved"}'

묻는 대신 알림 받기

웹훅 엔드포인트를 등록하면 그 ChatWoot의 어느 대화에서든 오가는 모든 메시지가 그곳으로 전송됩니다. 고객의 메시지는 chatwoot.message_received로, 팀의 메시지는 chatwoot.message_sent로 옵니다. 엔드포인트도 서명도 LinkedIn API와 같습니다.

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

자주 묻는 질문