시작하기

WhatsApp 비즈니스 계정 가져오기

WhatsApp 페이지로 이동해 계정 가져오기 버튼을 클릭하세요. Meta의 인증 흐름이 열리면 WhatsApp 비즈니스 계정과 전화번호를 선택하거나 생성하고, ElevenLabs에 관리 권한을 부여합니다.

에이전트 할당 및 동작 선택

가져오기가 완료되면 계정 설정 페이지로 이동합니다. 에이전트를 할당하세요. 할당하기 전까지는 수신 메시지가 무시되고 수신 통화는 거부됩니다.

이 번호에서 에이전트가 어떻게 동작할지 구성하세요(전체 참조는 계정 설정을 확인하세요).

• 메시지 활성화 — 에이전트가 메시지에 응답할지 여부입니다. 다른 시스템이 메시지를 처리하고 ElevenLabs는 통화만 처리해야 한다면 끄세요.
• 오디오 메시지 응답 활성화 — 켜면 에이전트가 음성 메모에 자체 음성의 음성 메모로 답하고, 끄면 항상 텍스트로 답합니다.
• 입력 표시기 활성화 — 켜면 에이전트가 수신 메시지를 읽음으로 표시하고 작업하는 동안 입력 표시기를 보여 줍니다.

첫 대화 시작

개인 휴대폰에서 비즈니스 번호로 메시지를 보내세요. 에이전트가 응답합니다. 음성 메모를 보내면 에이전트를 위해 텍스트로 변환되고, 에이전트는 자체 음성 메모로 응답합니다.

대화가 진행되는 동안 대화 기록에서 확인할 수 있습니다.

첫 발신 메시지 전송

먼저 사용자에게 연락하려면 Meta 승인을 받은 메시지 템플릿이 필요합니다. WhatsApp은 활성 대화 내에서만 자유 형식의 비즈니스 메시지를 허용합니다. WhatsApp Manager에서 다음과 같이 간단한 Utility 템플릿을 만드세요.

Hi {{name}}, thanks for signing up. Reply here if you have any questions.

템플릿이 승인되면 전송하세요.

from elevenlabs import ElevenLabs
elevenlabs = ElevenLabs()
elevenlabs.conversational_ai.whatsapp.outbound_message(
    whatsapp_phone_number_id="524029457612345",
    whatsapp_user_id="12213231492",
    template_name="welcome",
    template_language_code="en",
    template_params=[
        {
            "type": "body",
            "parameters": [
                {"type": "text", "parameter_name": "name", "text": "Daniele"}
            ],
        }
    ],
    agent_id="agent_9201kwcrbq9qfxaa2t8nnnkqf2w9",
)

여기서 두 가지가 중요합니다.

• template_params는 컴포넌트 객체 목록이며, {"type": "body", ...} 래퍼가 필요합니다.
• whatsapp_user_id는 국가 코드를 포함하고 + 없이 숫자만 사용합니다(예: 14155552671).

WhatsApp 페이지의 계정 메뉴에서 전화번호 ID 복사 옵션을 통해 whatsapp_phone_number_id를 찾으세요.

휴대폰에서 템플릿을 받게 됩니다. 여기에 답장하면 에이전트가 그 시점부터 대화를 이어갑니다.