Documentação · Integrações
Integrações do BoaVoz
O assistente do BoaVoz responde no WhatsApp, no Instagram e no site. Com as Integrações, ele consulta e faz coisas no sistema do seu cliente durante a conversa, manda botões, listas e carrosséis, e avisa o seu sistema do que acontece.
Por onde começar
Para agências →
Do cadastro ao chat no site e no WhatsApp do cliente, com a sua marca.
Para o seu negócio →
O assistente do seu negócio no site, no WhatsApp e no Instagram.
Para devs →
A chave, a primeira mensagem pela API e os eventos no seu sistema.
Para plataformas →
Um modelo e um chatbot por loja, criado pelo seu sistema.
O que dá para fazer
| Recurso | Para quê |
|---|---|
| Ações | Um endpoint seu que a IA chama na conversa: consultar pedido, agenda ou saldo; criar pedido ou agendar, com o Confirmar do contato. |
| Roteiros | Passos que a IA segue num assunto (segunda via, suporte): dado conferido, botões, a sua ação no passo, a identificação da pessoa e a foto pedida. |
| Mensagens ricas | Botões, lista, link e carrossel, num formato só, convertidos para cada canal. Um botão pode chamar uma ação direto, sem a IA. |
| Webhooks | Seu sistema fica sabendo na hora: mensagem recebida ou enviada, lead, pedido de atendente, aceite de novidades e mais. |
| API | Enviar mensagens e campanhas, ler conversas, leads e contatos, pausar a IA numa conversa. |
| Lojas pela API | Para plataformas: o cliente e o chatbot de cada loja a partir de um modelo, com o link de conexão, a equipe, a pausa e o uso. |
| Chat dentro de apps | O chat do site numa webview do seu app, com a pessoa identificada. |
Em que pacote
Ações na conversa, webhooks, a API e a identificação de usuários são o pacote Integrações (R$ 49 por mês, por conta). Sem ele, o painel não cadastra nem testa ações (os webhooks se cadastram e testam, mas não entregam); a IA não usa as ações, os webhooks não entregam e a API responde 403 plan_not_allowed. O pacote Plataforma (R$ 199 por mês, exige o Integrações) libera o segredo de identidade para todas as lojas, o chatbot modelo e as lojas pela API.
Onde configurar
- Ações: no painel, abra o chatbot e vá na aba Ações. Quem cadastra é o dono ou o administrador da agência (com a verificação em duas etapas).
- Webhooks, chaves de API e logs: menu Integrações do painel.
Antes de ligar no WhatsApp ou no Instagram
Nesses canais, o BoaVoz confere tudo o que sai para o contato pelas regras da Meta: itens proibidos não saem, e bebida alcoólica e remédio só aparecem para quem confirmou ter 18 anos. Isso vale também para o que a sua ação devolve. No site, essa trava não se aplica.Comece por aqui
Primeira ação →
Sua primeira ação funcionando em 5 minutos: consultar um pedido.
Ações →
O que o BoaVoz manda, o que ele aceita de volta, assinatura, prazos e o Confirmar.
Mensagens ricas →
Botões, lista, link e carrossel, e como ficam em cada canal.
Webhooks →
Os eventos, o envelope, a assinatura e as novas tentativas.
API →
Chave, convenções e erros, e uma página por assunto com exemplos em cURL e JavaScript.
Segurança →
Autorizar pelo contato verificado, segredos e LGPD.