🤖 Instalando o Botoscope na sua loja WooCommerce

Instalando o Botoscope na sua loja WooCommerce

Depois de criar seu bot, siga estas etapas para conectar seu site WooCommerce ao Botoscope:

🛠 Etapa 1: Edite seu arquivo wp-config.php

No seu servidor, abra o arquivo wp-config.php da sua instalação do WordPress e adicione as seguintes linhas antes da linha:

/* É isso, pare de editar! Feliz publicação. */

Use o seguinte código (valores de exemplo mostrados):

define('BOTOSCOPE_BOT_TOKEN', '123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11');
define('BOTOSCOPE_BOT_NAME', 'myshop_bot');
define('BOTOSCOPE_PROXY_SERVER', 'https://c12-t2hx7w.s2.botoscope.com');
define('BOTOSCOPE_CLIENT_API_KEY', 'bs-4a83c23c-7410ebfa-ac4z2ba3-b42c4a3f');
define('BOTOSCOPE_CLIENT_PASS', '6Jw6rzVxfdjwBEMtxtl');
define('BOTOSCOPE_ADMIN_CHAT_ID', 1234567890);

🔤 Configuração de Charset do Banco de Dados (Crítico para Suporte a Emojis)

⚠️ O Problema

Muitas instalações do WordPress ainda usam o antigo charset utf8, que NÃO suporta emojis. Isso causará:

• ❌ Emojis sendo removidos dos nomes/descrições dos produtos
• ❌ Erros no banco de dados ao salvar conteúdo com emojis
• ❌ Falha na criação de pedidos no Telegram
• ❌ Falhas na sincronização de produtos entre WooCommerce e Telegram

✅ A Solução

Abra seu arquivo wp-config.php e localize estas linhas (geralmente perto das configurações do banco de dados):

❌ ERRADO (formato antigo - NÃO suporta emojis):
define('DB_CHARSET', 'utf8');
define('DB_COLLATE', '');

Altere para:

✅ CORRETO (suporta emojis):
define('DB_CHARSET', 'utf8mb4');
define('DB_COLLATE', 'utf8mb4_unicode_ci');

📦 Etapa 2: Instale o plugin Botoscope

1. Faça login no painel de administração do WordPress.
2. Vá para Plugins → Adicionar Novo.
3. Carregue o arquivo ZIP do plugin Botoscope.
4. Clique em Instalar Agora, depois em Ativar.

⚙️ Etapa 3: Execute a configuração inicial

1. No painel de administração do WordPress, vá para Botoscope → Controles do Sistema.
2. Clique no botão “Redefinir cache completo de dados do bot”.
3. Aguarde cerca de um minuto — o site será sincronizado com sua loja no Telegram

✅ Você terminou!

Sua loja agora está conectada ao Telegram

Agora você pode:

• Gerenciar seus produtos
• Configurar sistemas de pagamento
• Controlar categorias e preços
• E muito mais — com base nas necessidades do seu negócio

🔧 Recursos Adicionais & Recomendações

🧩 Filtragem de Produtos

Se você deseja adicionar filtragem avançada de produtos, instale o
plugin HUSKY – WooCommerce Products Filter Professional:
🔗 https://products-filter.com/downloads

💱 Troca de Moeda

Se você deseja que seus clientes alternem entre moedas, instale o
plugin FOX – WooCommerce Currency Switcher Professional:
🔗 https://currency-switcher.com/downloads

📄 Download de Fatura em PDF para Clientes

Se você deseja que os clientes possam baixar faturas em PDF da página de pedidos ou e-mail, instale o plugin:
🔗 WooCommerce PDF Invoices & Packing Slips

Após a instalação, vá para wp-admin/admin.php?page=wpo_wcpdf_options_page → Aba Avançado e aplique as seguintes configurações:

1. Tipo de acesso ao link do documento → Completo
2. Links bonitos de documentos → Sim
3. Na aba Ferramentas → Gerar diretório temporário aleatório

Depois de instalar um ou todos os plugins recomendados, vá para as configurações do Botoscope, abra a aba Controles do Sistema e clique no botão “Redefinir cache completo de dados do bot”.

🔤 Configuração de Codificação do Banco de Dados (Para Suporte a Emojis)

🎯 Escolha Seu Método:

Oferecemos três maneiras fáceis de corrigir a codificação. Escolha a que funciona melhor para você:

• Método 1: Plugin de Um Clique (Mais Fácil!) 🎉
• Método 2: Código PHP (Para desenvolvedores) 💻
• Método 3: SQL Direto (Mais controle) 🔧

✨ Método 1: Plugin de Um Clique (Recomendado para Iniciantes)

Este é o método mais fácil – basta instalar um plugin e clicar em um botão!

1. No admin do WordPress, vá para Plugins → Adicionar Novo
2. Procure por “WP phpMyAdmin Extension”
3. Instale e ative o plugin: WP phpMyAdmin Extension
4. Vá para Ferramentas → phpMyAdmin no admin do WordPress
5. Clique na aba SQL
6. Copie e cole os comandos SQL do Método 3 abaixo
7. Clique em Ir

💻 Método 2: Código PHP de Uma Vez

Se você está confortável editando arquivos PHP, este método executa a conversão automaticamente quando você carrega uma página.

Opção A: Via functions.php do WordPress (Temporário)

1. Vá para Aparência → Editor de Arquivos do Tema
2. Abra functions.php (barra lateral direita)
3. Adicione este código no final do arquivo:

// TEMPORÁRIO: Converter banco de dados para UTF8MB4
// DELETE ESTE CÓDIGO APÓS EXECUTAR UMA VEZ!
add_action('admin_init', function() {
    if (!get_option('botoscope_db_converted_utf8mb4')) {
        global $wpdb;
        
        $prefix = $wpdb->prefix;
        
        // Tabelas do WooCommerce
        $tables = [
            'woocommerce_order_items',
            'woocommerce_order_itemmeta',
            'woocommerce_payment_tokens',
            'woocommerce_payment_tokenmeta',
            'woocommerce_sessions',
            'woocommerce_shipping_zones',
            'woocommerce_shipping_zone_locations',
            'woocommerce_shipping_zone_methods',
            'woocommerce_tax_rates',
            'woocommerce_tax_rate_locations',
        ];
        
        // Tabelas do Botoscope
        $botoscope_tables = [
            'botoscope_advertising',
            'botoscope_booking_reservations',
            'botoscope_booking_slots',
            'botoscope_booking_slots_targeted',
            'botoscope_broadcast',
            'botoscope_controls',
            'botoscope_elogios',
            'botoscope_extensions',
            'botoscope_interface_translations',
            'botoscope_marketing_campaigns',
            'botoscope_marketing_campaigns_products',
            'botoscope_marketing_campaigns_products_excluded',
            'botoscope_marketing_campaigns_terms',
            'botoscope_marketing_strategies',
            'botoscope_marketing_strategies_formulas',
        ];
        
        $all_tables = array_merge($tables, $botoscope_tables);
        
        foreach ($all_tables as $table) {
            $full_table = $prefix . $table;
            $wpdb->query("ALTER TABLE {$full_table} CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci");
        }
        
        update_option('botoscope_db_converted_utf8mb4', time());
        
        echo ''; } });

4. Clique em Atualizar Arquivo
5. Vá para qualquer página no admin do WordPress (como o Painel)
6. Você verá uma mensagem de sucesso quando a conversão for concluída
7. IMPORTANTE: Volte para o functions.php e DELETE o código que você acabou de adicionar

Opção B: Via Arquivo PHP Independente

1. Crie um novo arquivo chamado convert-db.php no diretório raiz do seu WordPress
2. Cole este código no arquivo:

<?php
// Carregar WordPress
require_once('wp-load.php');

if (!current_user_can('manage_options')) {
    die('Acesso negado');
}

global $wpdb;
$prefix = $wpdb->prefix;

echo '<h1>Convertendo Banco de Dados para UTF8MB4...</h1>';

// Tabelas do WooCommerce
$tables = [
    'woocommerce_order_items',
    'woocommerce_order_itemmeta',
    'woocommerce_payment_tokens',
    'woocommerce_payment_tokenmeta',
    'woocommerce_sessions',
    'woocommerce_shipping_zones',
    'woocommerce_shipping_zone_locations',
    'woocommerce_shipping_zone_methods',
    'woocommerce_tax_rates',
    'woocommerce_tax_rate_locations',
];

// Tabelas do Botoscope
$botoscope_tables = [
    'botoscope_advertising',
    'botoscope_booking_reservations',
    'botoscope_booking_slots',
    'botoscope_booking_slots_targeted',
    'botoscope_broadcast',
    'botoscope_controls',
    'botoscope_elogios',
    'botoscope_extensions',
    'botoscope_interface_translations',
    'botoscope_marketing_campaigns',
    'botoscope_marketing_campaigns_products',
    'botoscope_marketing_campaigns_products_excluded',
    'botoscope_marketing_campaigns_terms',
    'botoscope_marketing_strategies',
    'botoscope_marketing_strategies_formulas',
];

$all_tables = array_merge($tables, $botoscope_tables);

foreach ($all_tables as $table) {
    $full_table = $prefix . $table;
    
    echo "Convertendo {$full_table}... ";
    
    $result = $wpdb->query("ALTER TABLE {$full_table} CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci");
    
    if ($result !== false) {
        echo '<span style="color: green;">✅ Sucesso</span><br>';
    } else {
        echo '<span style="color: red;">❌ Falhou: ' . $wpdb->last_error . '</span><br>';
    }
}

echo '<h2 style="color: green;">✅ Conversão Completa!</h2>';
echo '<p><strong>IMPORTANTE:</strong> Exclua este arquivo (convert-db.php) do seu servidor agora!</p>';
?>

3. Carregue o arquivo no diretório raiz do seu WordPress (onde o wp-config.php está localizado)
4. Abra seu navegador e vá para: https://seusite.com/convert-db.php
5. Aguarde a conclusão da conversão
6. IMPORTANTE: Exclua o arquivo convert-db.php do seu servidor!

🔧 Método 3: SQL Direto no phpMyAdmin

Este é o método mais direto se você estiver confortável usando o phpMyAdmin.

📋 Instruções passo a passo:

1. Faça login no painel de controle do seu provedor de hospedagem (cPanel, Plesk, etc.)
2. Abra o phpMyAdmin
3. Selecione seu banco de dados do WordPress na barra lateral esquerda
4. Clique na aba SQL no topo
5. Copie e cole os comandos SQL abaixo
6. Clique em Ir para executar

-- Converter tabelas do WooCommerce
ALTER TABLE wp_woocommerce_order_items CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
ALTER TABLE wp_woocommerce_order_itemmeta CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
ALTER TABLE wp_woocommerce_payment_tokens CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
ALTER TABLE wp_woocommerce_payment_tokenmeta CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
ALTER TABLE wp_woocommerce_sessions CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
ALTER TABLE wp_woocommerce_shipping_zones CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
ALTER TABLE wp_woocommerce_shipping_zone_locations CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
ALTER TABLE wp_woocommerce_shipping_zone_methods CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
ALTER TABLE wp_woocommerce_tax_rates CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
ALTER TABLE wp_woocommerce_tax_rate_locations CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

-- Converter tabelas do Botoscope
ALTER TABLE wp_botoscope_advertising CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
ALTER TABLE wp_botoscope_booking_reservations CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
ALTER TABLE wp_botoscope_booking_slots CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
ALTER TABLE wp_botoscope_booking_slots_targeted CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
ALTER TABLE wp_botoscope_broadcast CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
ALTER TABLE wp_botoscope_controls CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
ALTER TABLE wp_botoscope_elogios CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
ALTER TABLE wp_botoscope_extensions CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
ALTER TABLE wp_botoscope_interface_translations CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
ALTER TABLE wp_botoscope_marketing_campaigns CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
ALTER TABLE wp_botoscope_marketing_campaigns_products CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
ALTER TABLE wp_botoscope_marketing_campaigns_products_excluded CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
ALTER TABLE wp_botoscope_marketing_campaigns_terms CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
ALTER TABLE wp_botoscope_marketing_strategies CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
ALTER TABLE wp_botoscope_marketing_strategies_formulas CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

-- Converter tabelas principais do WordPress (opcional, mas recomendado)
ALTER TABLE wp_posts CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
ALTER TABLE wp_postmeta CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
ALTER TABLE wp_comments CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
ALTER TABLE wp_commentmeta CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
ALTER TABLE wp_terms CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
ALTER TABLE wp_term_taxonomy CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
ALTER TABLE wp_term_relationships CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
ALTER TABLE wp_termmeta CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
ALTER TABLE wp_users CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
ALTER TABLE wp_usermeta CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
ALTER TABLE wp_options CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
ALTER TABLE wp_links CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

✅ Após a Conversão (Todos os Métodos):

1. Vá para Botoscope → Controles do Sistema no admin do WordPress
2. Clique em “Redefinir cache completo de dados do bot”
3. Teste a criação de um pedido com emoji no nome do produto – deve funcionar agora! ✨