문제 해결 및 FAQ

메시지가 수락되었지만 전달되지 않음

아웃바운드 메시지 엔드포인트에서 200 응답을 받았다는 것은 ElevenLabs가 요청을 수락하고 전달했다는 의미입니다. 실제 전달은 여전히 Meta가 담당합니다. 메시지가 도착하지 않는다면 다음 순서로 확인하세요.

1. 템플릿 승인 — 템플릿의 상태가 WhatsApp Manager에서 승인됨이어야 합니다. 보류 중이거나 거부된 템플릿은 전달되지 않습니다.
2. 결제 — WhatsApp 비즈니스 계정에 결제 수단이 없거나 미결제 금액이 있으면 템플릿 전달이 차단됩니다(Meta 오류 131042). WhatsApp Manager에서 결제 수단을 추가하거나 업데이트하세요.
3. 파라미터 형식 — template_params 항목은 컴포넌트 객체여야 하며({"type": "body", "parameters": [...]}), 템플릿의 모든 플레이스홀더를 채워야 합니다. 이름이 지정된 템플릿에서는 각 값에 parameter_name이 필요합니다. 템플릿 파라미터를 참고하세요.
4. 수신자 형식 — whatsapp_user_id는 국가 코드를 포함한 숫자만 사용하며, +는 포함하지 않습니다. 수신자 번호 형식을 참고하세요.
5. 마케팅 제한 — Meta는 한 사용자가 일정 기간에 수신할 수 있는 마케팅 템플릿 수를 제한합니다(오류 131049). 유틸리티 템플릿에는 이 제한이 적용되지 않습니다.

가져오기 문제

• 번호를 가져올 수 없음 — 다른 WhatsApp 제공업체에 등록되어 있거나 WhatsApp Business 앱에서 활성화되어 있습니다. 번호는 하나의 제공업체에만 등록할 수 있습니다. 제한 사항을 참고하세요.
• 가져오기 흐름에 WABA가 표시되지 않음 — WABA를 소유한 비즈니스 포트폴리오에 대한 관리자 권한이 있는 Facebook 계정으로 로그인했는지 확인한 후 다시 가져오기를 시도하세요.
• Meta 개발자 앱에서 생성된 WABA는 표준 흐름을 통해 가져올 수 없습니다.

다른 파트너가 번호를 관리하는지 확인

사용 자격이 없는 것으로 표시되거나, 가져오기 흐름에서 누락되거나, 가져오기 중 오류가 발생하는 번호는 이전 제공업체에 여전히 등록되어 있는 경우가 많습니다. 번호를 제어하는 파트너가 있으면 가져오기 실패와 WABA 누락이 모두 설명됩니다.

1. business.facebook.com으로 이동하여 비즈니스 포트폴리오를 선택하세요.
2. 비즈니스 설정 > WhatsApp 계정을 여세요.
3. 번호가 포함된 계정을 찾을 때까지 각 WhatsApp 계정의 전화번호를 확인하세요.
4. 파트너를 여세요.
5. 해당 파트너에서 번호 연결을 해제하거나 비즈니스 포트폴리오 전체를 삭제한 후, 몇 분 뒤에 다시 가져오기를 시도하세요.

에이전트가 수신 메시지에 응답하지 않음

읽음 확인 표시와 입력 중 표시기로 원인을 좁힐 수 있습니다. 두 표시는 에이전트가 답변을 생성하기 전, 메시지가 처리 대상으로 수락되는 즉시 전송됩니다. 기본값인 입력 중 표시기 활성화가 켜져 있는 상태에서 테스트 메시지를 보내고 메시지가 읽음으로 표시되는지, 입력 중 표시기가 나타나는지 확인하세요.

입력 중 표시기는 나타나지만 답변이 도착하지 않습니다. 메시지는 ElevenLabs에 도달했고 에이전트가 작업을 시작했습니다. 답변을 생성하거나 전달하는 동안 실패한 것입니다.

• 에이전트에 값이 없는 동적 변수가 필요합니다. 수신 WhatsApp 대화는 사용자가 제공한 동적 변수 없이 시작되며, 시스템 변수만 채워집니다. 해결 방법은 에이전트에 필요한 모든 변수를 반환하는 대화 시작 웹훅을 사용하는 것입니다. 초기화 컨텍스트를 참고하세요. 에이전트 편집기의 동적 변수에 입력한 값은 테스트용 플레이스홀더이며 프로덕션에서는 사용되지 않습니다.
• Meta가 에이전트의 답변을 거부했습니다. 예를 들어 이 비즈니스-사용자 쌍에 대한 속도 제한 또는 계정 수준의 결제 문제일 수 있습니다. 아래 오류 레퍼런스를 참고하세요.

필수 동적 변수가 없으면 대화가 실패합니다.

입력 중 표시기가 나타나지 않습니다. 메시지가 에이전트에 도달하기 전에 삭제되었습니다.

• 번호에 할당된 에이전트가 없거나 메시징 활성화 스위치가 꺼져 있습니다. WhatsApp 페이지에서 계정 설정을 확인하세요.
• 계정의 인증이 더 이상 유효하지 않습니다. Meta 측에서 액세스 토큰이 만료되었거나 취소되었습니다. WhatsApp 페이지에서 계정을 다시 가져오세요.
• 에이전트 워크스페이스가 수신 WhatsApp 메시지를 완전히 무시하는 제로 리텐션 모드에 있습니다.
• 수신 메시지가 지원되지 않는 유형입니다(예: 비디오 또는 WhatsApp Flow 응답). 제한 사항을 참고하세요.

템플릿 이후 첫 번째 답변이 비정상적으로 작동함

에이전트의 보안 탭에서 첫 번째 메시지 재정의가 활성화되어 있다면 아웃바운드 템플릿 대화와 충돌할 수 있습니다. 템플릿이 이미 첫 번째 메시지 역할을 했기 때문입니다. 템플릿에 대한 답변이 예상과 다르게 작동하면 WhatsApp 아웃바운드 메시지에 사용하는 에이전트의 첫 번째 메시지 재정의를 제거하세요.

Meta 오류 레퍼런스

Meta가 전달 중 반환하는 오류는 가능한 경우 해결 방법과 함께 표시됩니다. 가장 일반적인 오류는 다음과 같습니다.

전체 목록은 Meta의 오류 코드 레퍼런스를 참고하세요.

FAQ