> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# Brevo

리셉셔니스트는 Brevo를 통해 발신자에게 문자 메시지를 보낼 수 있습니다. 예를 들어 주소나 통화에서 합의한 내용의 요약을 보낼 수 있습니다. [웹훅 도구](/docs/ko/reception-ai/integrations/webhooks)가 SMS를 전송합니다. 연락처를 조회하고 저장하려면 Brevo의 [MCP 서버](/docs/ko/reception-ai/integrations/mcp-server)를 연결하세요.

> **Warning**
>
> 통화 중 메시지를 요청하거나 수신에 동의한 발신자에게만 문자를 보내고, 이 메시지는
> 거래성 메시지로 유지하세요. 프로모션은 보내면 안 됩니다. 마케팅 문자는 미국의 TCPA 및 EU의 GDPR과 같은 규정에 따라 사전 동의와 수신 거부 방법이 필요합니다. 활성화하기 전에 비즈니스에 적용되는 규정을 확인하세요.

## 후속 문자 보내기

### Brevo 계정 준비하기

SMS에는 선불 크레딧이 사용됩니다. Brevo에서 SMS 크레딧을 구매하고 문자를 보낼 국가에서 SMS 발송을 사용할 수 있는지 확인하세요. 미국과 캐나다 등 일부 국가에서는 사용자 지정 발신자 이름을 허용하지 않습니다.

### API 키 만들기

Brevo에서 **SMTP & API** → **API Keys**를 열고 **Generate a new API key**를 선택합니다. 이 키에서는 **Create MCP server API key**를 끈 상태로 둡니다. `xkeysib-`로 시작하는 키를 복사합니다.

### 웹훅 도구 만들기

**Integrations**로 이동한 다음 **Add integration**을 선택하고 **Webhook Tool**을 선택합니다.

| 필드                   | 값                                                                                                                                                                                                                                                                        |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Name**             | `send_followup_text`                                                                                                                                                                                                                                                     |
| **Description**      | "발신자에게 문자 메시지를 보냅니다. 발신자가 문자를 요청하거나 수신에 동의한 경우에만 사용하세요. 프로모션은 절대 보내지 마세요."                                                                                                                                                                                               |
| **Method**           | POST                                                                                                                                                                                                                                                                     |
| **URL**              | `https://api.brevo.com/v3/transactionalSMS/send`                                                                                                                                                                                                                         |
| **Request Headers**  | `api-key`: API 키  `accept`: `application/json`                                                                                                                                                                                                                           |
| **Body Parameters**  | `sender` (문자열, 필수): "항상 정확히 `YOUR_SENDER` 값을 사용합니다."  `recipient` (문자열, 필수): "국가 코드가 포함된 발신자의 휴대전화 번호입니다. 숫자만 사용하고 `+` 또는 공백은 제외합니다. 예: 14155550123."  `content` (문자열, 필수): "160자 미만의 문자 메시지입니다. 비즈니스 이름으로 시작합니다."  `type` (문자열, 필수): "항상 정확히 `transactional` 값을 사용합니다." |
| **Assign to agents** | **Receptionist**                                                                                                                                                                                                                                                         |

`YOUR_SENDER`를 발신자 이름(영문자와 숫자 최대 11자) 또는 발신 번호(최대 15자리)로 바꾸세요.

### 테스트하기

**Enable**을 선택한 후, 본인의 휴대전화 번호를 사용해 주소를 문자로 요청하여 [리셉셔니스트를 테스트](/docs/ko/reception-ai/receptionist/testing)하세요. Brevo의 SMS 로그에서 전송 상태를 확인할 수 있습니다.

160자를 초과하는 메시지는 여러 문자로 나뉘어 전송되며, 각 메시지에 크레딧이 사용됩니다.

## 연락처 조회 및 저장

### MCP 키 만들기

Brevo에서 **SMTP & API** → **API Keys**를 열고 **Generate a new API key**를 선택한 다음 **Create MCP server API key**를 켭니다. 키를 복사합니다.

> **Warning**
>
> MCP 키는 Brevo 계정에 대한 전체 읽기 및 쓰기 권한을 가집니다. SMS 키와 별도로 보관하고 아래의 연락처 모듈만 연결하세요.

### MCP 서버 추가하기

Reception.ai에서 **Integrations**로 이동한 다음 **Add integration**을 선택하고 **MCP Server**를 선택합니다.

| 필드               | 값                                             |
| ---------------- | --------------------------------------------- |
| **Name**         | Brevo 연락처                                     |
| **Server type**  | Streamable HTTP                               |
| **Server URL**   | `https://mcp.brevo.com/v1/brevo_contacts/mcp` |
| **Secret Token** | MCP 키                                         |

**Enable**을 선택합니다. Reception.ai가 키를 베어러 토큰으로 전송하고 Brevo의 연락처 도구를 표시합니다.

### 도구 할당하기

**Tools** 탭을 엽니다. 연락처를 조회하고 생성하는 도구를 **Client**(리셉셔니스트)에 할당합니다. 연락처를 삭제하거나 목록을 변경하는 도구는 할당하지 않거나 **Assistant**에만 할당하세요.

> **Note**
>
> `https://mcp.brevo.com/v1/brevo/mcp`는 이메일 캠페인을 포함한 모든 Brevo 모듈을 노출합니다. 팀이 **Assistant**에서 캠페인을 관리하도록 하려는 경우에만 사용하세요.

## 문제 해결

| 문제              | 확인할 사항                                                                              |
| --------------- | ----------------------------------------------------------------------------------- |
| Brevo가 401을 반환함 | 헤더 이름은 반드시 `api-key`여야 합니다. Brevo에서 인식되지 않은 IP 주소를 언급하면 Brevo 보안 설정의 승인된 IP를 확인하세요. |
| Brevo가 400을 반환함 | 번호에 국가 코드가 있고 `+`가 없는지, 발신자 이름이 최대 11자인지 확인하세요.                                     |
| 문자가 도착하지 않음     | SMS 크레딧과 해당 국가로 현재 발신자를 사용해 Brevo가 SMS를 보낼 수 있는지 확인하세요.                             |
| MCP 도구가 표시되지 않음 | **Streamable HTTP**와 SMS 키가 아닌 MCP 키를 사용하세요.                                        |
| MCP 키를 변경함      | 연동을 수정하고 **Rotate Secret Token (optional)** 을 사용하세요. 저장된 토큰은 다시 표시되지 않습니다.          |