웹사이트 방문자에게 답변은(는) /webchat/v1/conversations/{id}/messages에 대한 POST이며, MakeHybrid Website chat API에 속합니다. 조직의 웹사이트에 있는 조직 자신의 채팅으로, 팀이나 AI 에이전트가 답변합니다. 모든 요청은 X-API-KEY 헤더에 자신의 키를 싣습니다. 키는 LinkedIn API의 키와 같고, 조직 자신의 채팅에만 닿습니다.
이 채팅은 내 것이며, 다른 받은편지함 서비스가 아니라 저희가 보관합니다. 방문자의 대화는 내 키로만 접근할 수 있고, 방문자에게 답하는 AI 에이전트는 어떤 도구도 쓰지 않고 답합니다.
요청
curl -X POST "https://makehybrid.com/webchat/v1/conversations/$ID/messages" \
-H "X-API-KEY: $MAKEHYBRID_KEY" \
-H "content-type: application/json" \
-d '{}'
경로에 들어가는 것
- id — 이 계열의 앞선 호출이 돌려준 id.
안 될 때 돌아오는 것
- 401 — 키가 없거나, 틀렸거나, 폐기되었습니다.
- 402 — 요금제가 결제되지 않았습니다. 체험이 끝나면 MakeHybrid API가 이것을 돌려줍니다.
- 404 — 그것이 없거나, 조직의 것이 아니거나. id를 떠볼 수 없도록 둘 다 일부러 같은 답을 줍니다.
- 429 — 요청이 너무 많거나, 플랫폼이 속도를 늦추라고 요청하고 있습니다. 잠시 기다린 뒤 다시 시도하세요.
- 502 또는 503 — 플랫폼이 방금 응답하지 않았습니다. 잠시 뒤에 다시 시도하세요.
모든 오류는 같은 모양의 JSON입니다: {"type":"errors/<code>","status":<n>,"detail":"..."} — 핸들러 하나로 전부 받을 수 있고, detail은 사람에게 보여 주려고 쓴 문장입니다.
대신 어시스턴트에게 부탁하기
이 작업은 MCP 도구이기도 합니다. https://makehybrid.com/webchat/mcp/<your API key>를 Claude나 ChatGPT, 또는 MCP를 말하는 아무 어시스턴트에나 붙여 넣고 평범한 말로 부탁하세요 — 어시스턴트가 호출을 고르고 id를 채우고 답을 읽어 줍니다. https://makehybrid.com/mcp/<your API key>의 올인원 에이전트에도 들어 있어서 LinkedIn API 및 다른 모든 채널과 함께 쓸 수 있습니다.
프로젝트 룸에서
프로젝트 룸에서 내 AI 에이전트의 「사용할 수 있는 서버」 아래 이 API의 에이전트를 체크하면, 대화에 필요할 때마다 에이전트가 “웹사이트 방문자에게 답변”을(를) 도구로 호출합니다. 룸의 모두가 에이전트가 무엇을 요청했고 무엇이 돌아왔는지 볼 수 있습니다. 평범한 말로 부탁하세요. 여기서는 에이전트의 이름이 @scout입니다:
- @scout 아직 아무도 답하지 않은 웹사이트 채팅 대화를 나열하고, 내가 확인할 수 있게 각각에 보낼 답장 초안을 써 줘.
자주 묻는 질문
AI 에이전트가 나 대신 “웹사이트 방문자에게 답변”을(를) 호출할 수 있나요?
네. MCP를 지원하는 어시스턴트라면 위의 주소로 호출할 수 있고, 이 API의 에이전트를 체크한 프로젝트 룸의 내 AI 에이전트도 호출할 수 있습니다. 룸의 내장 에이전트는 할 수 없습니다. 조언만 할 뿐 내 키를 갖고 있지 않습니다.
룸 밖에서, 내 코드로도 되나요?
네. 위의 요청은 AI 에이전트의 도구가 호출하는 것과 같은 작업이며, 답도 오류도 같습니다. 어느 길로 들어오든 키가 닿는 채널은 같습니다.
내 브랜드의 룸에서도 되나요?
네. 화이트 라벨 주소에서는 API와 그 레퍼런스, AI 에이전트가 내 제품 이름으로 표시되며, 같은 규칙에 따라 같은 채널에 닿습니다.
AI 에이전트가 이 일을 하기 전에 사람이 승인할 수 있나요?
AI 에이전트의 지침에 써 두세요. 보내려는 내용을 말하고, 룸의 사람이 진행하라고 할 때까지 기다리라고요. 룸에서는 모든 답변이 모두에게 보이므로, 외부의 누군가에게 닿기 전에 그 문장이 눈에 띕니다.
어느 요금제인지
MakeHybrid API 요금제에 포함되며, LinkedIn API와 같은 키를 씁니다. 시트 하나당 월 9달러, 열 개부터는 7달러, 천 개부터는 5달러. 필요한 시트 수는 LinkedIn 계정, WhatsApp 번호, X 계정, 받은편지함 계정 중 가장 많이 가진 종류의 수와 같고, 30일 체험은 시트 하나에 대해서입니다.