목표: 고객이 내 WhatsApp 번호로 글을 보내면 AI 에이전트가 답을 초안으로 쓰고, 나가기 전에 사람이 승인합니다. 번호는 휴대폰에 있는 내 것 그대로이며, 아무도 읽지 않은 것은 전송되지 않습니다.
1. 번호 연결하기
curl -X POST https://makehybrid.com/whatsapp/v1/connection/link \ -H "X-API-KEY: $MAKEHYBRID_KEY"
돌려받은 url을 컴퓨터에서 열고 휴대폰으로 코드를 스캔하세요. WhatsApp에서 설정, 연결된 기기, 기기 연결을 누릅니다. 그런 다음 GET /whatsapp/v1/connection을 호출하면 번호가 연결된 것으로 표시됩니다.
2. 고객이 쓰는 글 받기
curl -X POST https://makehybrid.com/whatsapp/v1/webhooks/endpoints \
-H "X-API-KEY: $MAKEHYBRID_KEY" -H "content-type: application/json" \
-d '{"url":"https://acme.com/hooks/whatsapp","events":["whatsapp.message_received"]}'
3. 초안 작성, 승인, 전송
프로젝트 룸에서 내 AI 에이전트에게 「사용할 수 있는 서버」에서 WhatsApp 에이전트를 주고, 지침을 쓰세요. 새 메시지마다 답을 초안으로 쓰고, 초안을 룸에 올리고, 사람이 ‘보내’라고 답할 때만 보내라는 내용입니다. 룸에 있는 모두가 초안과 승인을 봅니다.
curl -X POST https://makehybrid.com/whatsapp/v1/messages \
-H "X-API-KEY: $MAKEHYBRID_KEY" -H "content-type: application/json" \
-d '{"to":"+15551234567","text":"Your order is on its way."}'
메시지는 10~20초 간격으로 나가므로, 답이 도착하기까지 그만큼 걸릴 수 있습니다. 먼저 글을 보냈거나 연락을 기다리는 사람에게만 쓰고, 같은 문구를 여러 사람에게 보내는 일은 절대 하지 마세요.
자주 묻는 질문
에이전트가 승인 없이 보낼 수 있나요?
지침에 그렇게 되어 있으면 보낼 수 있습니다. API는 막지 않습니다. 고객이 읽는 것이라면 룸에서 ‘보내’라는 말을 기다리는 쪽이 더 안전한 기본값입니다.
고객이 보낸 사진을 읽을 수 있나요?
메시지에 미디어가 있었다는 것은 알지만 파일은 보지 못합니다. 고객에게 내용을 설명해 달라고 하거나, 휴대폰에서 직접 답하세요.