# Provedor de SMS (Traga seu próprio Twilio) Esta página controla a conta Twilio usada para a **WhatsApp Business API**. Por padrão, a WhatsApp Business API é executada na conta Twilio gerenciada da plataforma — você nunca vê o Twilio e não precisa se inscrever no Twilio por conta própria. Se você conectou sua própria chave Anthropic (BYOK), as mensagens de WhatsApp via Twilio gerenciado custam 0,05 créditos cada, tanto de entrada quanto de saída. Em todas as outras contas, esses custos de entrega já estão cobertos pela sua taxa de crédito de IA, portanto, não há cobrança separada por mensagem. (A precificação de mensagens do próprio WhatsApp muda em 1º de outubro de 2026 — veja [Custos do WhatsApp e a Mudança de Outubro de 2026](../messaging-channels/whatsapp-pricing.md).) Isso só é relevante se você quiser especificamente que a WhatsApp Business API seja executada em sua própria conta Twilio. > **SMS é sempre "Traga seu próprio Twilio" (Bring Your Own Twilio).** A regulamentação de SMS (A2P 10DLC, registro de marca, aprovação de ID de remetente) precisa ser feita em nome da sua própria empresa, portanto, a plataforma não oferece números de SMS gerenciados. Configure o SMS separadamente usando o cartão **SMS via Twilio** em Configurações → Canais (há também uma opção de gateway de SMS para telefone Android). Esta página — o cartão **Conta Twilio** — controla a conta da WhatsApp Business API e não altera seu número de SMS. ## Por que eu mudaria a WhatsApp Business API para meu próprio Twilio? A maioria dos usuários não mudaria. A conta gerenciada é mais simples: - O aluguel de números do WhatsApp, envio de modelos, registro de remetente e integridade do número são todos tratados para você. Um número alugado aqui custa pelo menos 50 créditos por mês, e esse aluguel inclui a conexão com o WhatsApp — veja [Números de Telefone](phone-numbers.md#monthly-phone-number-billing). - Não há fatura separada do Twilio. Se você conectou sua própria chave Anthropic (BYOK), as mensagens de WhatsApp via Twilio gerenciado custam 0,05 créditos cada, tanto de entrada quanto de saída. Em todas as outras contas, esses custos de entrega já estão cobertos pela sua taxa de crédito de IA, portanto, não há cobrança separada por mensagem. Veja [Custos do WhatsApp e a Mudança de Outubro de 2026](../messaging-channels/whatsapp-pricing.md) para a mudança de precificação do WhatsApp que ocorrerá em 1º de outubro de 2026. - O suporte pode ajudar a depurar problemas de entrega diretamente. Você pode querer trazer seu próprio Twilio se: - Você já possui uma conta Twilio estabelecida com modelos de WhatsApp aprovados e números aquecidos que deseja continuar usando. - Sua empresa tem um motivo de aquisição ou conformidade para pagar o Twilio diretamente. - Você deseja visibilidade total do uso e preços em nível de operadora subjacente. > **Manter um número já aquecido é um trabalho de duas etapas.** A troca da conta (abaixo) apenas altera a conta da Twilio que usamos para o envio. Seu número de WhatsApp existente não aparece como um canal até que você também o anexe — veja [Anexando um número de WhatsApp que você já possui](#attaching-a-whatsapp-number-you-already-have). Faça-os nessa ordem. --- ## Como alternar **Como chegar lá:** Configurações → grupo **Canais** → **Canais**, então encontre o cartão **Conta Twilio**. O que você vê depende da sua configuração atual: ### Se você estiver na conta gerenciada (padrão) Você verá uma breve explicação e um botão **Gerenciar** no cartão da Conta Twilio. Clicar nele abre o formulário **Mudar para sua própria conta Twilio**, solicitando seu **Account SID** e **Auth Token** da Twilio — com o aviso de ação destrutiva exibido diretamente na caixa de diálogo. Antes de confirmar, leia os avisos com atenção — a alternância é destrutiva: - **Todos os números que você comprou através da plataforma serão liberados permanentemente.** Se você quiser continuar usando um número, mantenha-o na conta gerenciada (não alterne) ou compre/transfira-o para sua própria conta Twilio primeiro. - **Modelos de WhatsApp aprovados não serão transferidos.** Os modelos residem na Conta WhatsApp Business que possui o remetente — você precisará reenviá-los em sua própria conta e aguardar a nova aprovação. - **Chats e histórico de mensagens existentes permanecem visíveis**, mas novas respostas em números liberados falharão (o número não existe mais). - **Você pode voltar atrás mais tarde**, mas obterá uma nova conta gerenciada sem números e sem modelos — os antigos não retornam. Onde encontrar seu Account SID e Auth Token: faça login no Console do Twilio em [console.twilio.com](https://console.twilio.com). Ambos estão no painel principal, no painel "Account Info". O Account SID começa com `AC` e tem 34 caracteres de comprimento. Após inserir ambos os valores e confirmar, o sistema: 1. Valida se as credenciais funcionam. 2. Libera cada número de telefone gerenciado do Twilio. 3. Fecha a subconta gerenciada. 4. Salva suas credenciais para que todo futuro **WhatsApp** de saída use sua conta. Seu número de **SMS via Twilio** conectado separadamente é armazenado de forma independente e não é liberado ou alterado por esta alternância. Isso pode levar de alguns segundos a alguns minutos se você tiver vários números. ### Se você já está usando sua própria conta Twilio O cartão mostra sua conta conectada e permite que você volte para a configuração gerenciada. Voltar para a configuração gerenciada provisiona uma nova subconta gerenciada. Como mencionado acima: isso não restaura os números ou modelos que você tinha antes — você começará do zero. --- ## Anexando um número de WhatsApp que você já possui Uma vez que a conta esteja no seu próprio Twilio, o botão **Conectar WhatsApp** no cartão **WhatsApp Business API** altera o que ele oferece: a opção gerenciada torna-se **Através da sua conta Twilio**, que anexa um remetente de WhatsApp dentro da conta Twilio que você conectou, e a compra de um número gerenciado deixa de ser oferecida. Isso é intencional — comprar um número ou realizar a inscrição no Meta criaria uma segunda conta Twilio gerenciada pela plataforma ao lado da sua, e suas mensagens seriam então enviadas de uma conta enquanto o número reside na outra. ### Antes de começar Seu número já deve ser um remetente de WhatsApp funcional **dentro da sua própria conta Twilio**: - Ele está registrado como um remetente de WhatsApp na Twilio, anexado à sua própria Conta do WhatsApp Business. - A Twilio mostra esse remetente como **Online**. Esta tela não registra nada. Ela não cria um remetente, não se comunica com a Meta e não envia seu número para aprovação — ela conecta um remetente que já funciona. Se você ainda não tem um, faça a configuração do remetente do WhatsApp na Twilio primeiro. ### Etapas 1. Vá para **Configurações** → grupo **Canais** → **Canais**. 2. No cartão **WhatsApp Business API**, clique em **Anexar seu remetente**. 3. Insira o **Número do WhatsApp** no formato internacional (por exemplo, `+31612345678`), exatamente como aparece no remetente na Twilio. 4. Opcionalmente, dê a ele um **Rótulo** — um nome para o número dentro do aplicativo. Se deixado em branco, ele usa o nome no seu perfil de remetente da Twilio. 5. Clique em **Anexar remetente**. Você não precisa inserir novamente seu Account SID ou token de autenticação: nós já os temos a partir da troca de conta. ### O que acontece nos bastidores 1. Nós procuramos o remetente para esse número na sua conta Twilio e verificamos se a Twilio o mantém online. 2. Garantimos que um serviço de mensagens exista em sua conta e apontamos seu webhook de entrada para nós (criando um, nomeado após o aplicativo, caso você ainda não tenha um). É isso também que faz o envio de modelos funcionar. 3. Vinculamos seu remetente a esse serviço de mensagens. 4. Apontamos o próprio webhook do remetente para nós, para que as mensagens recebidas cheguem aqui. 5. O número aparece na sua lista de números, marcado como **Seu Twilio (BYO)**, pronto para ser atribuído a uma campanha ou agente. Seus modelos aprovados permanecem exatamente onde estão, na sua própria conta. Nada é reenviado e nada é liberado. ### Custos Não há cobrança de manutenção mensal em um número que você anexa desta forma — você paga à Twilio diretamente pelo número e suas taxas por mensagem. Respostas de IA ainda usam créditos normalmente. ### Se não funcionar - **"No WhatsApp sender for … exists in your Twilio account"** — o número não está registrado como um remetente do WhatsApp lá, ou foi digitado de forma diferente. Verifique o ID exato do remetente no Console do Twilio e insira-o novamente no formato internacional. - **"The WhatsApp sender … is not online in Twilio"** — o motivo do próprio Twilio está incluído na mensagem. Corrija-o primeiro no Twilio; anexar um remetente que o Twilio considera offline apenas causaria falhas silenciosas posteriormente. - **"… is already connected to another account"** — o número está vinculado a uma conta diferente aqui. Desconecte-o de lá primeiro. - **"This account is still on the managed Twilio account"** — faça a troca acima primeiro. - **"we could not update its webhook in Twilio"** — o número está vinculado e enviará mensagens, mas o remetente ainda aponta para qualquer webhook que você tinha nele. Limpe esse webhook no remetente no Console do Twilio para que as mensagens recebidas cheguem até nós. --- ## Limites - Você pode alternar de provedor no máximo uma vez a cada **24 horas**. Isso evita que repetições frequentes acumulem custos de API do Twilio e limites de taxa. - O envio de SMS não é afetado por essa configuração — se você já conectou seu próprio Twilio através do cartão **SMS via Twilio**, essa é uma conexão diferente e permanece onde está, independentemente do que você fizer aqui. --- ## E se algo der errado? - **"Não foi possível autenticar com as credenciais da Twilio fornecidas"** — verifique novamente o SID (começa com `AC`, 34 caracteres) e o token de autenticação. Ambos diferenciam maiúsculas de minúsculas. - **"A conta não está ativa"** — a conta da Twilio que você está tentando usar está suspensa ou encerrada. Use uma conta ativa. - **"Aguarde Xh antes de alternar novamente"** — você está dentro do período de espera de 24 horas. Aguarde o término. - **Migração parcial (alguns números liberados, outros não)** — execute a alternância novamente. O sistema é idempotente; ele continua de onde parou e termina de liberar o que ainda estiver na subconta gerenciada. Se você encontrar problemas após a troca — mensagens de saída não sendo enviadas, modelos não aparecendo — entre em contato com o suporte informando seu Account SID (nunca o token de autenticação). --- ## Precisa de ajuda? If you're not sure whether switching is right for you, or run into trouble, [contact support](mailto:hi@youraiconnector.com) and we can help you decide.