Visão geral
Você pode conectar sua conta comercial do WhatsApp a um Agente da ElevenLabs. O agente poderá então gerenciar:
- Conversas por mensagem — texto, mensagens de voz, mídia e mensagens interativas
- Chamadas — recebidas e realizadas
Agentes em outros canais também podem enviar mensagens pelo WhatsApp usando as ferramentas do WhatsApp.
É novo no WhatsApp da ElevenLabs? Siga o guia de introdução.
Importar uma conta comercial do WhatsApp
Autorize a ElevenLabs
Isso abrirá o fluxo de autorização, no qual você selecionará sua conta e dará à ElevenLabs permissão para gerenciá-la:
Atribua um agente
Ao terminar de importar sua conta, você será direcionado à página de configurações, onde poderá atribuir um agente a ela:
Se você não atribuir um agente à sua conta, as mensagens recebidas serão ignoradas e as chamadas recebidas serão recusadas. No entanto, você ainda poderá fazer chamadas realizadas.
Configure o Gerenciador do WhatsApp
Acesse o Gerenciador do WhatsApp para:
- Configurar sua foto de perfil etc.: abra a página Números de telefone, selecione um número e acesse a aba Perfil
- Permitir chamadas de voz: abra a página Números de telefone, selecione um número e acesse a aba Configurações de chamada
- Se quiser fazer chamadas realizadas, adicione uma forma de pagamento: abra a página Visão geral e clique no botão Adicionar forma de pagamento
Configurações da conta
Cada número importado tem configurações que controlam o comportamento do agente:
- Ativar mensagens — define se o agente responde às mensagens. Desative para que a ElevenLabs gerencie apenas as chamadas, enquanto seu próprio aplicativo gerencia as mensagens.
- Ativar resposta a mensagens de áudio — quando ativada (padrão), o agente responde a mensagens de voz com mensagens de voz; quando desativada, ele sempre responde com texto.
- Ativar indicador de digitação — quando ativada (padrão), o agente marca as mensagens recebidas como lidas e exibe um indicador de digitação enquanto elabora a resposta.
Conversas por mensagem
As conversas por mensagem no WhatsApp terminam quando o agente usa a ferramenta de sistema Encerrar conversa, quando a _Duração máxima da conversa _ configurada termina ou quando o tempo limite de inatividade padrão termina após a resposta mais recente do agente.
As conversas por mensagem no WhatsApp têm um tempo limite de inatividade padrão de 15 minutos, contado a partir da resposta mais recente do agente. Saiba mais sobre os tempos limite de conversa.
Recebidas
Você pode enviar uma mensagem para sua conta comercial do WhatsApp, e o agente responderá:
Quando qualquer um dos tempos limite expira, o ElevenAgents envia a _Mensagem de duração máxima da conversa _ configurada antes de encerrar a conversa. Se a mensagem estiver vazia, a conversa será encerrada sem despedida.
O agente entende mais do que texto simples:
- Respostas citadas — quando o usuário mantém uma mensagem pressionada e responde a ela, o agente sabe a qual mensagem ele está respondendo.
- Reações — reações com emoji às mensagens do agente são repassadas ao agente.
- Toques em botões de modelo — quando o usuário toca em um botão de resposta rápida em um modelo, o agente vê qual botão foi escolhido.
- Respostas interativas — toques em botões e listas interativas chegam com a opção selecionada.
O agente responde a cada mensagem recebida individualmente. Mensagens consecutivas enviadas rapidamente não são agrupadas em uma única resposta.
Realizadas
Você pode iniciar uma conversa enviando um modelo de mensagem aprovado pela Meta, pelo painel ou pela API, e agendar chamadas realizadas com uma solicitação de permissão de chamada. Consulte Mensagens realizadas e modelos para saber sobre a criação de modelos, exemplos de código, regras de formato de destinatários e campanhas em lote.
Tipos de mensagem
Além de texto, você também pode enviar:
- áudio
- Mensagens de voz recebidas são transcritas para texto antes de serem repassadas ao agente.
- Por padrão, o agente responde a mensagens de voz com mensagens de voz, geradas na voz configurada do agente — qualquer voz, qualquer idioma. Desative Ativar resposta a mensagens de áudio nas configurações da conta para sempre responder com texto. Se a geração de áudio falhar, o agente usará uma resposta em texto.
- Mensagens de áudio geram cobranças adicionais por conversão de fala em texto e texto em fala. Os preços são os mesmos das APIs de STT e TTS.
- imagem
- documento
- figurinha
- localização
- contato
Chamadas
Recebidas
Você pode ligar para sua conta comercial do WhatsApp, e o agente responderá. Durante a chamada, você também pode enviar mensagens de texto, que serão incorporadas à conversa.
Realizadas
Chamadas realizadas exigem a permissão do usuário, solicitada por meio de um modelo. Consulte agendar uma chamada realizada para ver o fluxo, exemplos de código e chamadas em lote.
Personalização
Definimos as variáveis dinâmicas {{system__caller_id}} e {{system__called_number}} com o ID de usuário do WhatsApp e o ID do número de telefone do seu WhatsApp (ou o inverso, dependendo de quem iniciou a conversa). Você pode usá-las em uma ferramenta ou em um webhook de início de conversa para buscar informações sobre o usuário na conversa.
Você pode encontrar o ID do número de telefone do seu WhatsApp acessando a página do WhatsApp, clicando no menu ao lado da sua conta e selecionando Copiar ID do número de telefone.
Contexto de inicialização
Se o seu agente usar variáveis dinâmicas além das variáveis de sistema acima, você precisará planejar de onde virão seus valores. Se o seu agente não usar variáveis dinâmicas, nada disso se aplica.
As conversas recebidas começam sem variáveis dinâmicas fornecidas pelo usuário. A forma compatível de fornecer valores é um webhook de início de conversa: quando uma mensagem do WhatsApp inicia uma conversa, o ElevenAgents chama seu endpoint com o ID de usuário do WhatsApp como caller_id e o ID do número de telefone do seu WhatsApp como called_number, e aplica as variáveis dinâmicas retornadas pela sua resposta. Faça o webhook sempre retornar todas as variáveis necessárias para o agente — um valor do CRM quando você tiver um, ou uma constante alternativa caso contrário.
Os valores inseridos em Variáveis dinâmicas no editor do agente são espaços reservados de teste para visualizar o agente. Eles não são usados em produção e não funcionam como padrões para conversas recebidas.
As conversas realizadas recebem seus valores do campo conversation_initiation_client_data.dynamic_variables da solicitação de mensagem ou chamada realizada. Esses valores permanecem durante toda a conversa e continuam disponíveis quando o usuário responde. Os parâmetros do modelo são um campo separado e não preenchem variáveis dinâmicas.
Uma variável obrigatória que ficar sem valor fará a conversa falhar. Consulte variáveis dinâmicas ausentes no guia de solução de problemas.
O valor de system__called_number é o ID do número de telefone do seu WhatsApp, não o número de telefone
em si. Os identificadores de usuários do WhatsApp também estão migrando para IDs de usuário com escopo empresarial
(BSUIDs);
o ElevenAgents oferece suporte a BSUIDs, então as conversas funcionam mesmo quando a Meta fornece um ID em vez do
número de telefone do usuário.
Limitações
Atualmente, não há suporte para:
- Fluxos do WhatsApp — formulários interativos não podem ser enviados, e as respostas de Fluxo não são repassadas ao agente.
- Mensagens de vídeo — vídeos recebidos não são repassados ao agente.
- Agrupamento de mensagens — o agente responde a cada mensagem individualmente, em vez de combinar mensagens consecutivas enviadas rapidamente.
- Números gerenciados por outro provedor — um número registrado com outro provedor do WhatsApp ou ativo no aplicativo WhatsApp Business não pode ser importado. Estamos trabalhando com a Meta para habilitar Conversas com Múltiplas Soluções; configurações apenas de voz já podem ser possíveis via SIP (consulte as Perguntas frequentes).
- WABAs criadas em um aplicativo de desenvolvedor — não podem ser importadas pelo fluxo padrão.
- Metadados de referência de anúncios — dados de atribuição de anúncios Click-to-WhatsApp não são expostos ao agente (consulte as Perguntas frequentes).
- Transferência para atendimento humano — em breve (consulte as Perguntas frequentes).
Perguntas frequentes
Dúvidas comuns — preços, configurações com vários provedores, transferência para atendimento humano, Modo de Retenção Zero, OTP, conformidade — são respondidas em Solução de problemas e perguntas frequentes.