> 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. # Integração nativa do Twilio ## Visão geral Este guia mostra como conectar um número de telefone da Twilio ao seu agente da ElevenLabs para atender chamadas recebidas e fazer chamadas de saída. Você aprenderá a: * Importar um número de telefone da Twilio existente. * Vinculá-lo ao seu agente para atender chamadas recebidas. * Iniciar chamadas de saída usando seu agente. ## Tipos e recursos de números de telefone A ElevenLabs oferece suporte a dois tipos de números de telefone da Twilio, com recursos diferentes: ### Números da Twilio adquiridos (suporte completo) * **Chamadas recebidas**: Compatível — pode receber chamadas e encaminhá-las para agentes * **Chamadas de saída**: Compatível — pode fazer chamadas usando agentes * **Requisitos**: O número deve ser adquirido pela Twilio e aparecer na seção "Phone Numbers" ### IDs de chamada verificados (somente saída) * **Chamadas recebidas**: Não compatível — não pode receber chamadas nem ser atribuído a agentes * **Chamadas de saída**: Compatível — pode fazer chamadas usando agentes * **Requisitos**: O número deve ser verificado na seção "Verified Caller IDs" da Twilio * **Caso de uso**: Ideal para usar seu número comercial existente em chamadas de saída com IA Saiba mais sobre [como verificar IDs de chamada em escala](https://www.twilio.com/docs/voice/api/verifying-caller-ids-scale) na documentação da Twilio. > **Note** > > Durante a importação do número de telefone, a ElevenLabs detecta automaticamente os recursos do seu número com base > na configuração dele na Twilio. ## Guia ### Pré-requisitos * Uma [conta da Twilio](https://twilio.com/). * Uma das opções abaixo: * Um [número de telefone](https://www.twilio.com/docs/phone-numbers) da Twilio adquirido e provisionado (para chamadas recebidas e de saída) * OU um [ID de chamada verificado](https://www.twilio.com/docs/voice/make-calls#verify-your-caller-id) na Twilio (somente para chamadas de saída) #### Importar um número de telefone da Twilio No painel do ElevenAgents, acesse a aba [**Phone Numbers**](https://elevenlabs.io/app/agents/phone-numbers). ![Página de números de telefone do ElevenAgents](/docs/_fern-img/7efb681147acd8f04803f84ed7f3289f0e90eb1fb0173e2a825836408cee89d1.webp) Em seguida, preencha os seguintes dados: * **Rótulo:** Um nome descritivo (por exemplo, `Linha de suporte ao cliente`). * **Número de telefone:** O número da Twilio que você quer usar. * **SID da Twilio:** O SID da sua conta da Twilio ou o SID da chave de API. * **Token da Twilio:** Seu token de autenticação da Twilio ou o segredo da chave de API. > **Tip** > > **Recomendado: use chaves de API para mais segurança.** Em vez de usar as credenciais de toda a sua conta, você pode [criar uma chave de API da Twilio](https://www.twilio.com/docs/iam/api-keys) com permissões limitadas. Ao criar uma chave de API, a Twilio fornece um **SID** (começa com `SK`) e um **Secret** — use-os nos campos acima. > **Note** > > Você pode encontrar o SID da sua conta e o token de autenticação [**no console de administração da Twilio**](https://www.twilio.com/console) ou criar chaves de API na [seção de chaves de API](https://www.twilio.com/console/project/api-keys). #### Painel do ElevenAgents ![Configuração do número de telefone](/docs/_fern-img/9501110d58bfeca27cb9983bc44035864504bdc2ed9c78d9decbd04802f64418.webp) #### Console de administração da Twilio Copie o SID da Twilio e o token de autenticação do [console de administração da Twilio](https://www.twilio.com/console). ![Detalhes do número de telefone](/docs/_fern-img/42da512d1cdfb4ca4504c3162fecfed108580d9488236a0cc6a4a1d23a19da14.webp) > **Note** > > A ElevenLabs configura automaticamente o número de telefone da Twilio com as definições corretas. #### Configurações aplicadas ![Configuração do número de telefone da Twilio](/docs/_fern-img/b11d57a0aa588964bbd0117d2135c55592569a4bf051f00f17aa3ee632833a47.webp) > **Info** > > **Detecção de número de telefone**: A ElevenLabs detectará automaticamente se o seu número oferece suporte a: > > * **Chamadas recebidas e de saída**: Números adquiridos pela Twilio > * **Somente chamadas de saída**: Números verificados como IDs de chamada na Twilio > > Se o seu número não for encontrado em nenhuma das categorias, você receberá um erro solicitando que confirme se ele existe na sua conta da Twilio. #### Atribuir seu agente (somente números compatíveis com chamadas recebidas) Se o seu número de telefone oferecer suporte a chamadas recebidas, você poderá atribuir um agente para atender chamadas recebidas. ![Selecionar agente para chamadas recebidas](/docs/_fern-img/b85c122ef8607527041516e789b0a19047cbf85a13cd3237ee5a7670683815a7.webp) > **Note** > > Números que oferecem suporte apenas a chamadas de saída (IDs de chamada verificados) não podem ser atribuídos a agentes e > aparecerão como desativados no menu suspenso de agentes. Teste o agente ligando para o número de telefone. Seu agente está pronto para atender chamadas recebidas e conversar com seus clientes. > **Tip** > > Monitore suas primeiras chamadas no [painel de histórico de chamadas](https://elevenlabs.io/app/agents/history) para garantir que tudo esteja funcionando como esperado. ## Como fazer chamadas de saída > **Info** > > Tanto números da Twilio adquiridos quanto IDs de chamada verificados podem ser usados para chamadas de saída. O botão de > chamada de saída ficará desativado para números que não oferecem suporte a chamadas de saída. Seu número de telefone da Twilio importado também pode ser usado para iniciar chamadas de saída, em que seu agente liga para um número de telefone especificado. #### Iniciar uma chamada de saída Na aba [**Phone Numbers**](https://elevenlabs.io/app/agents/phone-numbers), localize o número da Twilio importado e clique no botão **Outbound call**. ![Botão de chamada de saída](/docs/_fern-img/953a870b0ab0c0aa30872b3692260f0879f390d4b4b83c7f82e816385504034f.webp) #### Configurar a chamada Na janela modal de chamada de saída: 1. Selecione o agente que conduzirá a conversa 2. Insira o número de telefone para o qual você quer ligar 3. Clique em **Send Test Call** para iniciar a chamada ![Configuração de chamada de saída](/docs/_fern-img/f6b01412a68217661028e6924ce90089bdd5eaa693c8aeafbc321c632de921b7.webp) Depois de iniciada, a pessoa receberá uma chamada do seu número da Twilio. Quando atender, seu agente iniciará a conversa. > **Tip** > > As chamadas de saída aparecem no seu [painel de histórico de chamadas](https://elevenlabs.io/app/agents/history) > junto das chamadas recebidas, permitindo que você revise todas as conversas. > **Note** > > Ao fazer chamadas de saída, seu agente iniciará a conversa. Portanto, configure mensagens iniciais adequadas > para que ele possa começar a conversa de forma eficiente.