WhatsApp 도구

개요

다른 채널(예: 전화)에서 진행 중인 대화 중에도 에이전트가 WhatsApp으로 메시지를 보낼 수 있도록 도구를 제공할 수 있습니다.

WhatsApp 통합은 세 가지 도구를 제공합니다.

• 메시지 보내기 — 모든 WhatsApp 사용자에게 템플릿 메시지를 보냅니다. 모든 채널에서 작동하므로, 예를 들어 전화 에이전트가 발신자의 WhatsApp으로 확인 메시지를 보낼 수 있습니다. 이 페이지에서는 이 도구를 다룹니다.
• 대화형 버튼 보내기 및 대화형 목록 보내기 — 진행 중인 WhatsApp 메시지 대화의 사용자에게 탭할 수 있는 선택지를 제공합니다. 이 도구들은 WhatsApp 메시지 대화에서만 작동합니다. 대화형 메시지를 참조하세요.

설정

1

계정 가져오기

WhatsApp 비즈니스 계정을 가져오려면 여기의 안내를 따르세요.

2

통합 추가하기

통합 페이지로 이동해 _Add integration _ 버튼을 클릭하고 WhatsApp을 선택한 후 계정을 연결하세요.

3

도구 추가하기

도구 페이지로 이동해 _Add integration tool _ 버튼을 클릭하고 WhatsApp 통합 및 _ Send Message _ 도구를 선택하세요.

도구 사용하기

1

메시지 템플릿 만들기

WhatsApp Manager로 이동해 Manage templates 페이지를 열고 메시지 템플릿을 만드세요.

현재 이 도구는 메시지 본문의 파라미터만 지원합니다.

2

에이전트 구성하기

에이전트 구성으로 이동해 도구를 추가하세요.

시스템 프롬프트에서 에이전트에 다음을 알려주세요.

• 도구를 사용할 시점
• 사용할 템플릿 이름과 언어 코드
• 전달할 파라미터

3

테스트

도구 구성을 테스트하세요.

파라미터 및 언어 코드

이 도구는 템플릿의 본문 파라미터만 채웁니다. 파라미터가 있는 헤더나 버튼이 포함된 템플릿은 이 도구에서 지원되지 않습니다. 수신자는 WhatsApp 사용자 ID이며, 국가 코드를 포함한 숫자만 사용하고 +는 사용할 수 없습니다(예: 14155552671). 국가별 주의 사항은 수신자 번호 형식 규칙을 참조하세요.

템플릿 언어 코드는 WhatsApp Manager에서 템플릿을 만들 때 사용한 언어와 일치해야 합니다. 지원되는 언어 코드를 참조하세요. 흔히 발생하는 실수는 en_US로 만든 템플릿에 en을 전달하는 경우(또는 그 반대)입니다. Meta는 이를 서로 다른 템플릿으로 처리합니다.

문제 해결

• 템플릿을 찾을 수 없음: 템플릿 이름 또는 언어 코드가 WhatsApp Manager의 값과 정확히 일치하지 않거나, 템플릿이 연결된 계정과 다른 WhatsApp 비즈니스 계정에 속해 있습니다.
• 메시지는 수락되었지만 전달되지 않음: 템플릿이 승인되지 않았거나, 본문 파라미터가 누락되었거나, 계정에 결제 문제가 있습니다. 문제 해결 및 FAQ를 참조하세요.
• 에이전트가 잘못된 파라미터를 전달함: 시스템 프롬프트에 템플릿의 정확한 파라미터 이름과 예상 값을 명시하고 호출 예시를 하나 제공하세요.