Como integrar comentários do YouTube à Nvoip
Use a integração com o YouTube para receber novos comentários públicos de vídeos e Shorts em um fluxo da Nvoip. O BOT pode responder, transferir o atendimento para uma fila e permitir que uma pessoa continue a conversa pelo Atendimento. Cada resposta enviada pela Nvoip é publicada no comentário original do YouTube.
Antes de começar
Confirme estes requisitos:
- use uma conta Nvoip direta com acesso a Integrações, Fluxos e Atendimento;
- entre no Google com uma conta que administre o canal que será conectado;
- prepare um fluxo com entrada do YouTube e um BOT ou uma Fila de Mensageria;
- combine com a equipe que as respostas serão públicas no YouTube;
- não inclua senhas, dados pessoais, informações financeiras ou conteúdo interno nas respostas.
A integração recebe comentários novos depois da conexão. Ela não importa todo o histórico anterior do canal e não transforma o YouTube em uma conversa privada.
Passo 1 — Conectar o canal
- No painel Nvoip, abra Integrações.
- Localize YouTube e abra os detalhes.
- Na aba Configuração, clique em Adicionar canal.
- Na janela do Google, escolha a conta que administra o canal.
- Revise e autorize a leitura de comentários e a publicação de respostas.
- Retorne à Nvoip e aguarde o canal aparecer como Conectado.
Se a conta Google administrar mais de um canal, selecione e conecte cada canal separadamente. Antes de prosseguir, confira o nome e o identificador exibidos na Nvoip.
Passo 2 — Criar o fluxo de comentários
- Abra Fluxo e crie um novo fluxo.
- Adicione YouTube como canal de entrada.
- Selecione o canal conectado que deve iniciar o fluxo.
- Conecte a entrada a um bloco de Horário, quando necessário.
- Direcione o caminho para um BOT ou para uma Fila de Mensageria.
- Resolva as pendências do editor, salve e publique o fluxo.
O canal escolhido identifica a origem do comentário. Vídeos comuns e Shorts usam a mesma entrada. Sem um fluxo publicado para o canal, os novos comentários aguardam configuração por até 30 dias e nenhum BOT é acionado.
Passo 3 — Configurar o BOT e a transferência
No BOT, deixe claro que a resposta será pública. Use mensagens curtas e adequadas ao contexto do vídeo. Se precisar continuar com uma pessoa, conecte o caminho do BOT a uma Fila de Mensageria.
Boas práticas:
- responda apenas ao que está visível no comentário;
- convide o cliente para um canal privado quando o assunto exigir dados pessoais;
- evite prometer prazos ou condições que não estejam confirmados;
- não use anexos: respostas do YouTube aceitam texto;
- revise o tom da automação para vídeos e Shorts.
Passo 4 — Atender e responder
Quando um comentário novo seguir o fluxo, a Nvoip abre um atendimento próprio com o autor, o texto e o link do vídeo. Comentários diferentes permanecem isolados em atendimentos diferentes.
Depois que o BOT transferir o atendimento:
- assuma o atendimento na fila;
- leia o comentário original e abra o vídeo quando precisar de contexto;
- escreva somente o texto que deve aparecer publicamente;
- envie a resposta uma vez;
- confira o estado apresentado pela Nvoip e, quando necessário, valide a resposta no YouTube.
Se o envio ficar com resultado incerto, atualize o atendimento antes de tentar de novo. Repetir a ação pode publicar respostas duplicadas.
O que a integração acessa
A integração usa os serviços de API do YouTube para:
- identificar os canais que a conta Google autorizada administra;
- ler comentários públicos novos dos canais conectados;
- publicar respostas públicas solicitadas pelo fluxo ou por um atendente;
- manter o vínculo técnico necessário à sincronização.
Ao conectar, você concorda com os Termos do YouTube e com a Política de Privacidade da Nvoip. A Nvoip não apaga comentários ou vídeos no YouTube por meio desta integração.
Desconectar, revogar ou excluir dados
As ações têm efeitos diferentes:
| Ação | Resultado |
|---|---|
| Desconectar | Interrompe a coleta de novos comentários daquele canal. As respostas já publicadas continuam no YouTube. |
| Revogar acesso no Google | Remove a autorização Google deste projeto para o usuário e pode afetar outros canais conectados pelo mesmo usuário. |
| Excluir dados do YouTube | Solicita a remoção das cópias e valores derivados da API na Nvoip em até sete dias. Respostas próprias do BOT ou operador e dados independentes da Nvoip são preservados. |
Desconectar na Nvoip não revoga automaticamente o acesso no Google. Para conferir ou remover a autorização, use Gerenciar acesso no Google na tela da integração.
Solução de problemas
| Situação | O que verificar |
|---|---|
| O cartão do YouTube não aparece | Perfil da conta, permissões de Integrações e disponibilidade da versão publicada do painel |
| A janela do Google não abre | Bloqueio de pop-up do navegador e nova tentativa pelo botão Adicionar canal |
| O canal esperado não aparece | Conta Google escolhida e permissão de administrador do canal |
| O canal está conectado, mas nenhum comentário chega | Fluxo publicado para aquele canal, execução ativa e comentário criado depois da conexão |
| O comentário chegou, mas o BOT não respondeu | Caminhos do fluxo, horário, configuração do BOT e eventual limite da API do YouTube |
| A resposta não foi publicada | Estado do comentário, permissão concedida, cota da API e mensagem de erro exibida no Atendimento |
| A autorização expirou | Use Reconectar e conclua novamente o acesso no Google |
Perguntas frequentes
A integração funciona com Shorts?
Sim. Comentários de vídeos e Shorts usam a mesma entrada do YouTube no fluxo.
Os comentários antigos serão importados?
Não. Considere a integração para novos comentários recebidos depois da conexão. O histórico anterior não é importado em massa.
A resposta da Nvoip é privada?
Não. Ela é publicada como resposta pública no comentário original do YouTube. Para assuntos sensíveis, encaminhe a pessoa para um canal privado autorizado.
Posso conectar mais de um canal?
Sim. Adicione os canais separadamente e selecione o canal correto em cada fluxo.
Excluir os dados na Nvoip apaga o comentário no YouTube?
Não. A solicitação remove as cópias sujeitas à exclusão na Nvoip; nada é apagado no YouTube.
Precisa de ajuda?
No Suporte Técnico do painel, informe o canal, o vídeo, o horário aproximado, o nome do fluxo e a mensagem de erro. Não envie senha, token Google ou informações pessoais desnecessárias.