Ajuda

Primeiros passos

Do cadastro ao primeiro cliente atendido — seis etapas. No primeiro registro você recebe um teste de um mês com acesso total.

Conectando canais

Guias passo a passo para cada canal. Os canais são conectados por site (widget) no dashboard, na seção “Canais”; depois que um canal é salvo, o Smartbtn verifica se a plataforma aceita mensagens. As mensagens de todos os canais chegam em “Conversas”.

Bot de telegramaVocê precisará de: um bot do @BotFather, seu nome de usuário e token.6 passos → Comunidade VKVocê precisará de: uma chave de acesso da comunidade e o link ou ID da comunidade.5 passos → Bot MÁXIMOVocê precisará de: uma organização verificada em business.max.ru, o apelido do bot e o token.6 passos → WhatsApp Business (API em nuvem)Você precisará de: um aplicativo Meta Business com WhatsApp, um número, ID do número de telefone, WABA ID e um token permanente.6 etapas · cerca de 10 minutos → Contas AvitoVocê precisará de: uma conta Avito com uma assinatura adequada; autorização via Avito.4 etapas → CIANVocê precisará de: o plano CIAN “Básico”, a chave API CIAN e o endereço da conta.5 passos → Facebook MensageiroVocê precisará de: um token de acesso à página de longa duração e o endereço da página.5 passos → Robô ViberVocê precisará de: um bot comercial do Viber, seu URI e token (chave do aplicativo).5 passos → OK grupoVocê precisará de: uma chave de acesso e o link da caixa de diálogo do grupo.6 passos → AliExpressVocê precisará de: um token API da conta do vendedor do AliExpress e o endereço ou ID da loja.5 passos → Mensagens da Apple para empresasVocê precisará de: uma conta do Messages for Business vinculada à Infobip, Apple Business ID e uma chave API da Infobip.7 passos → WordPress e outros CMSInstalando o código do widget em um site construído com um CMS.3 etapas →

Bot de telegrama

Os clientes escrevem para o seu bot no Telegram, você responde no Smartbtn – a resposta chega no Telegram.

1. Crie um bot com @BotFatherNo Telegram, abra @BotFather, envie o comando /newbot e defina o nome e nome de usuário do bot. O nome de usuário deve terminar com “bot”.
2. Copie o tokenBotFather envia um token como 123456:AAH… – copie‑o completamente.
3. Digite o nome de usuário do botNo painel, abra “Canais”, escolha Telegram e digite o nome de usuário do bot sem @.
4. Cole o tokenCole o token no campo “Token do bot”.
5. Conectar telegramaClique em “Conectar telegrama”. Smartbtn pergunta ao Telegram se o bot responde — a marca verde aparece somente após sua resposta.
6. Enviar/iniciar para o botAbra o bot no Telegram e envie /start. Depois disso, ele pode conversar com os clientes.

Comunidade VK

Mensagens para sua comunidade VK chegam ao Smartbtn; as respostas voltam para VK em nome da comunidade. Você pode conectar várias comunidades.

1. Crie uma chave de acesso da comunidadeNa comunidade abra “Gerenciar” → “Avançado” → “Uso de API” → guia “Tokens de acesso” → “Criar token”. Marque os direitos “Mensagens da comunidade”, “Gestão da comunidade”, “Fotos”, “Documentos” e clique em “Criar”; confirme no aplicativo VK ou por SMS.
2. Cole a chaveNo painel, abra “Canais” → VK e cole a chave no campo “Token da comunidade”.
3. Especifique a comunidadeNo campo “Link ou ID da comunidade” cole o endereço da comunidade (por exemplo, vk.com/club123456) ou seu ID numérico.
4. Conecte a comunidadeClique em “Conectar”. O recebimento de mensagens (API Callback, evento message_new) é configurado automaticamente – nada mais a fazer.
5. VerifiqueEnvie uma mensagem de teste para a comunidade — ela deve aparecer em “Conversas”.

Bot MÁXIMO

As mensagens para o seu bot no MAX messenger chegam ao Smartbtn, as respostas voltam para o MAX.

1. Crie um bot na plataforma parceira MAXFaça login em business.max.ru (ou no miniaplicativo “MAX for business”), crie e verifique o perfil da sua organização, empresário individual ou autônomo (disponível para residentes russos) e, em “Bots de bate‑papo”, clique em “Criar”.
2. Preencha o cartão do botFaça upload de um logotipo, defina o nome e a descrição. O apelido é gerado automaticamente (como idINN_bot). Após a criação o bot passa por moderação.
3. Copie o tokenApós a moderação, abra “Chat bots” → seu bot → ⋮ → “Settings” e copie o token.
4. Digite o apelido do botNo painel, abra “Canais” → MAX e digite o apelido sem @.
5. Cole o tokenCole o token no campo “Token do bot”.
6. SalvarClique em “Salvar configurações”.

WhatsApp Business (API em nuvem)

O WhatsApp está conectado através da API oficial Meta WhatsApp Business Cloud: um número atende conversas e envia mailings com modelos aprovados. A configuração na seção “Conexões” leva cerca de 10 minutos.

1. Crie um aplicativo MetaNo Meta for Developers, crie um aplicativo Business (ou use um existente) e adicione o produto WhatsApp.
2. Adicione o númeroWhatsApp → Configuração da API: adicione seu número (não deve ser utilizado no aplicativo WhatsApp), confirme com um código e aguarde a aprovação do nome de exibição.
3. Copie os IDsCopie o ID do número de telefone e o ID da conta comercial do WhatsApp.
4. Crie um token permanenteMeta Business → Configurações → Usuários do sistema: crie um administrador, atribua a ele o aplicativo e a conta do WhatsApp, gere um token que nunca expira com as permissões whatsapp_business_messaging e whatsapp_business_management.
5. Salve e verifiqueNo painel abra “Conexões” → WhatsApp, cole os dados e clique em “Salvar e verificar”.
6. Ativar mensagens recebidasClique em “Conectar automaticamente” e escolha os sites (projetos) para respostas e mailings.

Contas Avito

Os bate‑papos do Avito são conectados por contas: cada conta é uma autorização separada no Avito, você pode adicionar várias. É necessária uma assinatura Avito: “Máximo” para Bens e Empregos, “Estendido” ou “Máximo” para Serviços.

1. Nomeie a contaEm “Canais” → Avito insira um nome de conta (até 50 caracteres) – isso ajuda a diferenciar as contas.
2. Adicione a contaClique em “Adicionar conta” – a página de autorização do Avito é aberta.
3. Permitir acessoFaça login na conta Avito correta, verifique os direitos de leitura e modificação de mensagens no Avito messenger e clique em “Autorizar aplicativo”.
4. Gerenciar contasAdicione mais contas ou exclua as desnecessárias – a lista está na mesma página.

CIAN

As mensagens da sua conta CIAN chegam ao Smartbtn.

1. Obtenha a chave API CIANO plano “Básico” é obrigatório. Na conta CIAN abra a seção API e clique em “Obter chave API”.
2. Encontre a chave em seu e‑mailA CIAN envia a CHAVE DE ACESSO para o email da conta. Certifique‑se também de que o recebimento de mensagens esteja ativado em my.cian.ru/settings/chats.
3. Digite o endereço da contaEm “Canais” → CIAN cole o endereço da sua conta CIAN.
4. Cole a chaveCole a chave no campo “CIAN API key (ACCESS KEY)”.
5. SalvarClique em “Salvar configurações”.

Facebook Mensageiro

As mensagens enviadas para sua página do Facebook no Messenger chegam ao Smartbtn. O Messenger permite respostas de formato livre dentro de 24 horas após a mensagem do cliente.

1. Escolha MensageiroEm “Canais” clique no ícone do Messenger.
2. Obtenha o token da páginaObtenha um token de acesso à página de longa duração seguindo o guia Meta para desenvolvedores.
3. Digite o endereço da páginaCole o endereço da página do Facebook no campo “Endereço da página do Facebook”.
4. Cole o tokenCole o token da página no campo “Chave secreta”.
5. SalvarClique em “Salvar configurações”.

Robô Viber

As mensagens para o seu bot Viber chegam ao Smartbtn.

1. Escolha ViberEm “Canais” clique no ícone do Viber.
2. Obtenha um bot ViberDesde 5 de fevereiro de 2024, os bots do Viber são criados apenas em termos comerciais: inscreva‑se diretamente no Viber ou por meio de seu parceiro oficial (developers.viber.com). O token está no Viber: Mais → Configurações → Bots → Editar informações → “Sua chave de aplicativo”.
3. Insira o URI do botCole o URI do bot (o mesmo dos links viber://pa?chatURI=…) no campo “URI do bot”.
4. Cole o tokenCole a chave do aplicativo no campo “Token do bot”.
5. SalvarClique em “Salvar configurações”.

OK grupo

As mensagens para o seu grupo OK chegam ao Smartbtn.

1. Obtenha uma chave de acessoObtenha a chave de acesso do grupo conforme descrito no guia da API OK.
2. Escolha OKEm “Canais” clique no ícone OK.
3. Digite o endereço do grupoNas configurações do grupo, copie de “Link direto para a caixa de diálogo do grupo” a parte como group/58269558636565/messages e cole‑a no campo “Endereço do grupo”.
4. Cole a chaveCole a chave da etapa 1 no campo “Chave de acesso (token)”.
5. SalvarClique em “Salvar configurações”. O webhook é registrado automaticamente.
6. VerifiqueSmartbtn mostra se OK confirmou o recebimento de mensagens. Envie uma mensagem de teste para o grupo — ela aparecerá em “Conversas”.

AliExpress

As mensagens do comprador do AliExpress chegam ao Smartbtn.

1. Abra a página de tokens de APIFaça login na conta do vendedor (seller.aliexpress.ru) e abra seller.aliexpress.ru/token‑management/active.
2. Crie um tokenClique em “Criar token”, depois clique no token e copie‑o.
3. Especifique a lojaEm “Canais” → AliExpress insira o endereço ou ID da sua loja.
4. Cole o tokenCole o token no campo “token API”.
5. SalvarClique em “Salvar configurações”.

Apple Messages for Business

As mensagens do Apple Messages for Business (anteriormente Business Chat) chegam ao Smartbtn por meio do provedor Infobip: a Apple não dá acesso direto às empresas.

1. Registre‑se na AppleNo Apple Business Register (register.apple.com) registre a organização e crie uma conta do Messages for Business; escolha a Infobip como Provedora de Serviços de Mensagens.
2. Vincule a conta à InfobipVincule a conta à sua conta Infobip e aguarde a aprovação da Apple — o status passa a ser ONLINE.
3. Insira o URL base da InfobipEm “Canais” → Mensagens para Empresas cole seu URL Base da Infobip (como xxxxx.api.infobip.com).
4. Insira o ID comercial da AppleCopie‑o no Apple Business Register: a conta Mensagens para Empresas → “Links” → “Copiar ID”.
5. Cole a chave API da InfobipCrie uma chave de API no Infobip (gerenciamento de chaves de API) e cole‑a — a URL de retorno de chamada aparece abaixo.
6. Defina o URL de retorno de chamada no InfobipNa Infobip: Canais e Números → Canais → Apple Messages for Business → Remetentes → ⋮ → Editar configurações de entrada → Encaminhamento para HTTP, cole o URL de retorno de chamada.
7. SalvarClique em “Salvar configurações”.

WordPress, Tilda e outros CMS

O widget é instalado com um código de instalação – funciona em qualquer site e CMS.

1. Copie o código de instalaçãoNo painel abra “Widget” e copie o código de instalação.
2. Cole no siteAdicione o código a todas as páginas antes da tag de fechamento : no WordPress — através do tema (footer.php) ou qualquer plugin para inserir código no cabeçalho/rodapé; em outro CMS — no campo para código HTML/JS personalizado.
3. VerifiqueAbra o site — o botão aparece; outras alterações de design são feitas no painel sem reinstalar o código.

Base de conhecimento

Ajudará, sugerirá, ensinará. Comece a digitar – a lista é filtrada conforme você digita.

smartbtn_widget_api.setContactInfo({
  name: "Alex Morgan",
  email: "email@example.com",
  phone: "+17584987855",
  description: "Description text"
});

smartbtn_widget_api.setCustomData([
  {
    title: "Actions",
    content: "Add contact",
    link: "https://crm.example.com/contacts/new"
  },
  {
    content: "Open customer profile",
    link: "https://crm.example.com/customers/42"
  }
]);

curl -H "Authorization: Bearer <token>" https://<host>/api/v1/chats

// → { "data": [...], "next_cursor": "..." | null }

• Janela autônoma do PWA sem barra de endereço do navegador, com emblema Dock e notificações Web Push
• Acesso instantâneo a todas as ferramentas: WhatsApp, Telegram, Instagram, Messenger, copiloto AI, chatbot, retorno de chamada, direções, preço
• Notificações push para novas mensagens e solicitações de retorno de chamada
• Monitoramento do operador, temporizadores de SLA e estatísticas — direto no aplicativo

Contate‑nos

Tem alguma dúvida ou sugestão? Escreva para nós!

Detalhes da empresa

Detalhes do operador para contratos e faturas.

Documentos legais

Termos de utilização do serviço e tratamento de dados pessoais.