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 do WhatsApp via Twilio gerenciado custam 0,05 créditos cada, de entrada e saída, e em todas as outras contas esses custos de entrega são cobertos pela sua taxa de crédito de IA. A partir de 1º de outubro de 2026, cada número gerenciado será cobrado por mensagem, de entrada e saída, independentemente de você usar sua própria chave ou não. (Os preços das mensagens do próprio WhatsApp mudarão em 1º de outubro de 2026 — veja Custos do WhatsApp e a Mudança de Outubro de 2026.) Isso só é relevante se você quiser especificamente que a WhatsApp Business API seja executada em sua própria conta Twilio.

SMS é sempre Bring Your Own Twilio (Traga seu próprio Twilio). A regulamentação de SMS (A2P 10DLC, registro de marca, aprovação de ID de remetente) deve 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 (também há uma opção de gateway de SMS para telefone Android). Esta página — o cartão Conta Twilio — controla a conta da API do WhatsApp Business e não altera seu número de SMS. Um número da sua própria conta Twilio pode executar a API do WhatsApp Business e o SMS ao mesmo tempo, conectados em qualquer ordem. Ele então aparece no cartão da API do WhatsApp Business e no cartão SMS via Twilio, e cada cartão controla apenas seu próprio canal: remover o número de um deixa o outro em funcionamento.

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, o envio de modelos, o registro de remetentes e a integridade dos números 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.
• Não há fatura separada do Twilio. Se você conectou sua própria chave Anthropic (BYOK), as mensagens do WhatsApp via Twilio gerenciado custam 0,05 créditos cada, de entrada e saída, e em todas as outras contas esses custos de entrega são cobertos pela sua taxa de crédito de IA. A partir de 1º de outubro de 2026, cada número gerenciado será cobrado por mensagem, de entrada e saída, independentemente de você usar sua própria chave ou não. Veja Custos do WhatsApp e a Mudança de Outubro de 2026 para a mudança de preços 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. 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. 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 Conectar WhatsApp, escolha Usar um número que você já possui, e então Através da sua conta Twilio.
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 usará o nome do seu perfil de remetente na 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 em sua conta Twilio e verificamos se a Twilio o mantém online.
2. Nós 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 é o que faz o envio de modelos funcionar.
3. Nós vinculamos seu remetente a esse serviço de mensagens.
4. Nós apontamos o próprio webhook do remetente para nós, para que as mensagens recebidas cheguem aqui.
5. O número aparece em sua lista de números, marcado como Seu Twilio (BYO), pronto para ser atribuído a um 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? #

Se você não tem certeza se a mudança é ideal para você, ou se encontrar problemas, entre em contato com o suporte e nós podemos ajudar você a decidir.