문자 메시지 보내기
messages 노드를 사용하여 고객에게 문자 메시지를 보낼 수 있습니다.
1단계: /messages로 POST 요청 보내기
메시지를 보내고자 하는 사용자의 WhatsApp ID를 보유하고 있으면 이 ID로 문자 메시지를 전송합니다. type 필드에서 text를 지정합니다.
POST /v1/messages
{
"preview_url": false | true,
"recipient_type": "individual",
"to": "whatsapp-id",
"type": "text",
"text": {
"body": "your-text-message-content"
}
}
매개변수에 대한 자세한 내용은 다음을 참조하세요.
메시지 서식을 지정하고자 하는 경우 문자 메시지 서식 지정을 참조하세요.
문자 메시지에서 URL 보내기
기본적으로 모바일 WhatsApp 앱은 URL을 인식하고 클릭이 가능합니다. URL 미리 보기를 포함하려면 메시지 본문에 "preview_url": true를 포함하고 URL이 http:// 또는 https://로 시작하는지 확인하세요. IP 주소가 일치하지 않으면 호스트 이름이 필요합니다.
여기에서 preview_url을 사용하는 방법은 클라우드 API와 다릅니다. 메시지 클라우드 API 문서를 참조하세요.
예
{
"preview_url": true,
"to": "whatsapp-id",
"text": {
"body": "You have to check out this amazing messaging service https://www.whatsapp.com/"
}
URL을 보내는 경우 대부분 미리 보기가 포함되었는지 여부와 관계없이 메시지 수신자에게 클릭할 수 있는 URL이 표시됩니다.
URL 미리 보기는 다음 중 한 가지가 발생한 이후에만 렌더링됩니다.
- 비즈니스가 사용자에게 메시지 템플릿을 보냈습니다.
- 사용자가 '클릭하여 채팅' 링크로 대화를 시작합니다.
- 사용자가 주소록에 비즈니스의 전화번호를 추가하고 대화를 시작합니다.
2단계: 응답 확인
성공한 응답에는 새로 만든 메시지의 ID가 있는 messages 개체가 포함되어 있습니다.
{
"messages": [{
"id": "gBEGkYiEB1VXAglK1ZEqA1YKPrU"
}]
}
실패한 응답에는 오류 메시지가 포함됩니다. 자세한 내용은 오류 및 상태 코드를 참조하세요.