Controle o ESP32 com Alexa e Google Home: Espalexa ou Sinric Pro
Controle um ESP32 ou ESP8266 com Alexa e Google Home: dispositivos locais com Espalexa, nuvem com Sinric Pro, ligação do relé, soluções para a descoberta e uma comparação.
Integrar o ESP32 com a Alexa é o jeito mais rápido de controlar uma lâmpada, um ventilador ou uma tomada que você mesmo montou dizendo “Alexa, acenda a luz”. Há duas formas práticas de conectar um ESP32 ou ESP8266 à Alexa e ao Google Home: a biblioteca Espalexa faz a placa parecer uma lâmpada Philips Hue na sua rede local, enquanto o serviço em nuvem Sinric Pro a liga à Alexa e ao Google Home ao mesmo tempo. As duas pedem só algumas linhas de código, mas funcionam de maneiras completamente diferentes nos bastidores.
Neste guia você vai ver primeiro em que os dois métodos diferem e quando escolher cada um. Depois vai montar um projeto com Espalexa usando um módulo relé e uma fita de LED dimerizável, aprender o que verificar quando a Alexa não encontra o seu dispositivo e controlar o mesmo relé pelo Google Home com o Sinric Pro. Os sketches compilam sem alterações tanto no ESP32 quanto no ESP8266 (NodeMCU, Wemos D1 Mini).

Como um ESP32 conversa com a Alexa e o Google Home?
O Espalexa faz o ESP32 aparecer na sua rede local como uma ponte Philips Hue. Quando o seu Echo recebe o comando “descobrir dispositivos”, ele envia uma mensagem SSDP multicast para a rede; o ESP32 responde “sou uma lâmpada Hue” e o Echo o adiciona à lista. A partir daí, os comandos não passam pela internet: vão direto para o ESP32 pela porta 80 da sua rede doméstica. Isso é rápido e não exige conta, mas só funciona com a Alexa e só quando há um dispositivo Echo na mesma rede. O Google Home não oferece suporte a essa emulação local do Hue, então você precisa chegar até ele pela nuvem: com o Sinric Pro, o ESP32 mantém uma conexão WebSocket permanente com a internet, você vincula a sua conta do Sinric Pro no app da Alexa ou do Google e o comando de voz viaja da nuvem até a placa.
| Método | Alexa | Google Home | Internet | Dificuldade | Observação |
|---|---|---|---|---|---|
| Espalexa | Sim (local) | Não | Não precisa | Fácil | Exige um Echo na mesma rede |
| FauxmoESP | Sim (local) | Não | Não precisa | Fácil | Parecido com o Espalexa, precisa das bibliotecas Async |
| Sinric Pro | Sim (skill) | Sim | Obrigatória | Fácil | Precisa de conta e de ID do dispositivo; a quantidade de dispositivos depende do plano |
| Home Assistant + ESPHome | Sim | Sim | Em geral, para os assistentes de voz | Média | Comanda a casa inteira a partir de uma única central |
| Matter (core ESP32 3.x) | Sim | Sim | Não precisa | Avançada | Precisa de uma central ou caixa de som compatível com Matter |
Lista de componentes e ligações
Os exemplos usam uma placa ESP32 ou ESP8266, um módulo relé de um canal e, opcionalmente, uma fita de LED de 12 V acionada por um MOSFET. Para a fita de LED, escolha um MOSFET de nível lógico como o IRLZ44N, coloque um resistor de 220 Ω em série no gate e um resistor de pull-down de 10 kΩ entre o gate e o GND; os detalhes estão no guia de MOSFET.
| Ligação | ESP32 | ESP8266 (NodeMCU / Wemos D1 Mini) |
|---|---|---|
| VCC do módulo relé | VIN (5 V) | VIN ou 5V |
| GND do módulo relé | GND | GND |
| IN do módulo relé | GPIO 26 | D1 (GPIO 5) |
| Gate do MOSFET da fita de LED | GPIO 25 | D2 (GPIO 4) |
| Botão (exemplo do Sinric Pro) | GPIO 0 (BOOT) | D3 (GPIO 0, FLASH) |

Método 1: um dispositivo Alexa local com o Espalexa
- Instale a biblioteca Espalexa (Christian Schwinne) pelo Gerenciador de Bibliotecas.
- Informe o nome e a senha do seu Wi-Fi; o ESP32 e o ESP8266 só se conectam a redes de 2,4 GHz.
- Mantenha os nomes dos dispositivos curtos e fáceis de falar, e confira se nenhum outro dispositivo no seu app Alexa já usa o mesmo nome.
- Carregue o sketch, veja o endereço IP da placa no Monitor Serial e diga “Alexa, descubra meus dispositivos”, ou abra o app Alexa e vá em Dispositivos > + > Adicionar dispositivo > Outro > Descobrir dispositivos.
- Os dispositivos aparecem no app Alexa como lâmpadas do tipo Philips Hue; adicione-os a cômodos e grupos, se quiser.
1#ifdef ESP8266
2 #include <ESP8266WiFi.h>
3#else
4 #include <WiFi.h>
5#endif
6#include <Espalexa.h>
7
8const char* WIFI_SSID = "WIFI_ADI"; // 2,4 GHz ağın adı / your 2.4 GHz network name
9const char* WIFI_PASS = "WIFI_SIFRESI";
10
11#ifdef ESP8266
12const int RELAY_PIN = 5; // D1
13const int LED_PIN = 4; // D2 (MOSFET üzerinden LED şerit / LED strip via MOSFET)
14#else
15const int RELAY_PIN = 26;
16const int LED_PIN = 25;
17#endif
18const int RELAY_ON = LOW; // çoğu röle modülü LOW ile çeker / most relay modules switch on LOW
19
20Espalexa espalexa;
21
22void setLed(uint8_t value) { // 0-255 parlaklık / brightness
23#if defined(ESP8266)
24 analogWrite(LED_PIN, value);
25#elif ESP_ARDUINO_VERSION_MAJOR >= 3
26 ledcWrite(LED_PIN, value);
27#else
28 ledcWrite(0, value);
29#endif
30}
31
32// Aç-kapa cihaz: röle / on-off device: relay
33void onLight(EspalexaDevice* d) {
34 bool on = d->getState();
35 digitalWrite(RELAY_PIN, on ? RELAY_ON : !RELAY_ON);
36 Serial.printf("Light: %s\n", on ? "ON" : "OFF");
37}
38
39// Kısılabilir cihaz: 0 = kapalı, 1-255 = parlaklık / dimmable device: 0 = off, 1-255 = brightness
40void onStrip(uint8_t brightness) {
41 setLed(brightness);
42 Serial.printf("Strip: %d%%\n", brightness * 100 / 255);
43}
44
45void setup() {
46 Serial.begin(115200);
47 pinMode(RELAY_PIN, OUTPUT);
48 digitalWrite(RELAY_PIN, !RELAY_ON); // başlangıçta kapalı / off at start
49#if defined(ESP8266)
50 pinMode(LED_PIN, OUTPUT);
51#elif ESP_ARDUINO_VERSION_MAJOR >= 3
52 ledcAttach(LED_PIN, 5000, 8); // 5 kHz, 8 bit
53#else
54 ledcSetup(0, 5000, 8);
55 ledcAttachPin(LED_PIN, 0);
56#endif
57 setLed(0);
58
59 WiFi.mode(WIFI_STA);
60 WiFi.begin(WIFI_SSID, WIFI_PASS);
61 while (WiFi.status() != WL_CONNECTED) {
62 delay(500);
63 Serial.print(".");
64 }
65 Serial.println(WiFi.localIP());
66
67 // Alexa'daki adlar: kendi dilinde yaz (Lampe, Lamba...) / names in Alexa: use your own language
68 espalexa.addDevice("Light", onLight, EspalexaDeviceType::onoff);
69 espalexa.addDevice("LED Strip", onStrip, 0);
70 espalexa.begin(); // 80. portta web sunucusu açar / starts a web server on port 80
71}
72
73void loop() {
74 espalexa.loop(); // Alexa isteklerini dinle / handle Alexa requests
75 delay(1);
76}O sketch define dois dispositivos diferentes. Light usa EspalexaDeviceType::onoff, só pode ser ligado e desligado e aciona o relé; o callback dele recebe um ponteiro EspalexaDevice e lê o estado com getState(). LED Strip é dimerizável: o valor de brilho de 0–255 que vem da Alexa vai direto para a saída PWM, e 0 significa desligado. A parte do PWM traz uma separação para as versões 2.x e 3.x do core do ESP32: no 3.x você usa ledcAttach(pino, frequência, resolução) e ledcWrite(pino, valor); no 2.x, ledcSetup e ledcAttachPin. A regra mais importante está no loop(): o espalexa.loop() precisa rodar com muita frequência; chamadas longas de delay() fazem a Alexa avisar que “o dispositivo não está respondendo”.
| Comando | Exemplo | Espalexa | Sinric Pro (Switch) |
|---|---|---|---|
| Ligar | Alexa, acenda a luz / Ok Google, acenda a luz | Sim | Sim |
| Desligar | Alexa, desligue a fita de LED / Ok Google, apague a luz | Sim | Sim |
| Brilho | Alexa, coloque a fita de LED em 40 por cento | Sim (tipo dimerizável) | Com o tipo Dimmable Switch |
| Cor | Alexa, deixe a luz azul | Sim (tipo com cor) | Com o tipo Light |
| Rotina e grupo | Alexa, boa noite | Sim, pelas rotinas do app | Sim |
A Alexa não encontra o dispositivo: solução de problemas do Espalexa
- Sem dispositivo Echo: O app Alexa do celular não consegue descobrir dispositivos locais sozinho; quem faz a busca é um Echo na rede.
- Redes diferentes: O ESP32 e o Echo precisam estar no mesmo roteador e na mesma sub-rede. Redes de convidados, isolamento de clientes (AP) ou uma rede IoT separada bloqueiam as mensagens multicast.
- Configurações do roteador: Alguns roteadores e sistemas mesh filtram o tráfego SSDP e UPnP. Deixe o ESP32 perto do roteador durante a descoberta e mantenha o multicast (IGMP) ativado.
- Porta 80 em uso: Se outro servidor web no mesmo sketch usa a porta 80, o Espalexa não funciona. Entregue o seu servidor ao Espalexa com espalexa.begin(&server) ou junte os dois.
- Dispositivo renomeado: Se você mudou o nome de um dispositivo no código, apague os dispositivos antigos no app Alexa e faça a descoberta de novo.
- Dispositivos demais: O limite padrão é de 10 dispositivos. Para ter mais, escreva #define ESPALEXA_MAXDEVICES 20 antes de incluir o Espalexa.h.
Método 2: Alexa e Google Home com o Sinric Pro
- Crie uma conta no site do Sinric Pro e adicione um dispositivo do tipo Switch em Devices > Add Device; dê a ele o nome do jeito que você vai falar.
- Copie para o sketch o APP KEY e o APP SECRET da página Credentials e o Device ID da lista de dispositivos.
- Instale a biblioteca SinricPro pelo Gerenciador de Bibliotecas; as bibliotecas WebSockets e ArduinoJson, que ela exige, vêm junto.
- No app Alexa, ative a skill Sinric Pro em Skills e jogos, vincule a sua conta e deixe que ela descubra os dispositivos.
- No app Google Home, vá em + > Configurar dispositivo > Funciona com o Google, procure por Sinric Pro e entre com a mesma conta.
1#ifdef ESP8266
2 #include <ESP8266WiFi.h>
3#else
4 #include <WiFi.h>
5#endif
6#include <SinricPro.h>
7#include <SinricProSwitch.h>
8
9#define WIFI_SSID "WIFI_ADI"
10#define WIFI_PASS "WIFI_SIFRESI"
11#define APP_KEY "APP_KEY_BURAYA" // Sinric Pro > Credentials
12#define APP_SECRET "APP_SECRET_BURAYA"
13#define SWITCH_ID "CIHAZ_ID_BURAYA" // Sinric Pro > Devices
14
15#ifdef ESP8266
16const int RELAY_PIN = 5; // D1
17const int BUTTON_PIN = 0; // D3 (FLASH düğmesi / FLASH button)
18#else
19const int RELAY_PIN = 26;
20const int BUTTON_PIN = 0; // BOOT düğmesi / BOOT button
21#endif
22const int RELAY_ON = LOW;
23
24bool relayState = false;
25unsigned long lastPress = 0;
26
27void setRelay(bool on) {
28 relayState = on;
29 digitalWrite(RELAY_PIN, on ? RELAY_ON : !RELAY_ON);
30}
31
32// Alexa ya da Google Home'dan gelen komut / command from Alexa or Google Home
33bool onPowerState(const String& deviceId, bool& state) {
34 setRelay(state);
35 Serial.printf("Cloud: %s\n", state ? "ON" : "OFF");
36 return true; // komut uygulandı / command executed
37}
38
39void setup() {
40 Serial.begin(115200);
41 pinMode(RELAY_PIN, OUTPUT);
42 setRelay(false);
43 pinMode(BUTTON_PIN, INPUT_PULLUP);
44
45 WiFi.mode(WIFI_STA);
46 WiFi.begin(WIFI_SSID, WIFI_PASS);
47 while (WiFi.status() != WL_CONNECTED) {
48 delay(500);
49 Serial.print(".");
50 }
51
52 SinricProSwitch& mySwitch = SinricPro[SWITCH_ID];
53 mySwitch.onPowerState(onPowerState);
54 SinricPro.onConnected([]() { Serial.println("Sinric Pro: connected"); });
55 SinricPro.begin(APP_KEY, APP_SECRET);
56}
57
58void loop() {
59 SinricPro.handle(); // bulut bağlantısını canlı tut / keep the cloud link alive
60
61 // Fiziksel düğme: röleyi değiştir, durumu uygulamalara bildir / physical button: toggle and report
62 if (digitalRead(BUTTON_PIN) == LOW && millis() - lastPress > 500) {
63 lastPress = millis();
64 setRelay(!relayState);
65 SinricProSwitch& mySwitch = SinricPro[SWITCH_ID];
66 mySwitch.sendPowerStateEvent(relayState);
67 }
68}O onPowerState roda sempre que a Alexa ou o Google Home envia um comando de ligar ou desligar; retornar true avisa a nuvem de que o comando foi executado, enquanto false faz o assistente dizer que o dispositivo não está respondendo. O botão BOOT da placa funciona aqui como um interruptor físico: ele alterna o relé e envia o novo estado para a nuvem com sendPowerStateEvent, de modo que os apps do celular sempre mostram o estado real. A espera de meio segundo elimina o repique do botão e impede que o sketch envie mais de um evento por segundo para a nuvem. Como os comandos viajam pela internet, o atraso costuma ficar entre meio segundo e um segundo.
Usando um ESP8266 (NodeMCU, Wemos D1 Mini)
Graças às linhas #ifdef ESP8266 no início, os dois sketches também compilam para o ESP8266; só mudam a biblioteca de Wi-Fi e os números dos pinos. No ESP8266, D1 (GPIO 5) e D2 (GPIO 4) são os pinos mais seguros para um relé. D3 (GPIO 0), D4 (GPIO 2) e D8 (GPIO 15) precisam estar em níveis específicos na inicialização, então um relé ligado a eles pode impedir a placa de iniciar ou dar um clique rápido ao ser energizada. O ESP8266 gera PWM por software; desde o core 3.x, o analogWrite() usa por padrão a faixa de 0–255, então você pode usar diretamente o valor de brilho do Espalexa. Para os detalhes da placa, veja o guia do ESP8266 NodeMCU.
Ideias de projeto: lâmpada, tomada inteligente, ventilador e fita de LED
- Tomada inteligente: Coloque o relé em uma caixa fechada e acrescente controle por voz ao projeto da tomada inteligente com ESP32.
- Acionamento silencioso: Se o clique incomoda, use um relé de estado sólido (SSR) no lugar do mecânico.
- Luz colorida: Combine o tipo com cor do Espalexa com uma fita WS2812B e mude as cores com “Alexa, deixe a luz vermelha”.
- Firmware pronto: Para fitas de LED sem escrever código, instale o WLED, que já traz o Espalexa embutido.
- Alimentação compacta: Tire 5 V direto da rede elétrica com um HLK-PM01 para o projeto caber dentro de uma caixa de embutir.
- Ventilador e aquecedor: Combine o relé com um sensor de temperatura e acione o ventilador tanto automaticamente quanto por voz.
Problemas comuns e soluções
| Sintoma | Causa provável | Solução |
|---|---|---|
| A Alexa não encontra o dispositivo | ESP em uma rede de convidados ou nenhum Echo na rede | Mesma rede de 2,4 GHz e mesma sub-rede; faça a descoberta por um Echo |
| “O dispositivo não está respondendo” | delay longo no loop() ou queda do Wi-Fi | Remova os delays, use millis() e reconecte o Wi-Fi |
| O relé nunca desliga | O módulo de 5 V ignora o sinal de 3,3 V ou a lógica LOW/HIGH está invertida | Altere RELAY_ON; use um módulo com acionamento em 3,3 V ou um transistor |
| O relé dá um clique ao ligar a placa | Relé em um pino de strapping | Use um pino seguro, como o GPIO 26 no ESP32 ou o D1 no ESP8266 |
| O Sinric Pro não conecta | APP KEY, APP SECRET ou Device ID errado | Copie os valores do portal de novo e confira o Monitor Serial |
| O Google Home não mostra o dispositivo | Conta não vinculada | Vincule o Sinric Pro em Funciona com o Google e sincronize os dispositivos |
| Erro de compilação "std::variant" | Sinric Pro 4.x ou posterior com o core 2.x do ESP32 | Atualize o core para 3.x ou instale a versão 3.5.0 da biblioteca |
Fazer um ESP32 conversar com a Alexa e o Google Home é o primeiro passo rumo à casa inteligente, e basta um relé e algumas linhas de código: o Espalexa é local e rápido, enquanto o Sinric Pro oferece um caminho flexível para os dois assistentes. No app BlueGrays você encontra projetos de ESP32 com conexão Wi-Fi, servidor web, mDNS e atualizações OTA, com esquemas do circuito e código passo a passo, prontos para você acrescentar o controle por voz.
Perguntas frequentes
O controle do ESP32 pela Alexa funciona sem um dispositivo Echo?
Com o Espalexa, não, porque os dispositivos locais são descobertos por uma caixa de som Echo na rede; só o app do celular não basta. Sem um Echo, use um serviço em nuvem como o Sinric Pro, e os comandos também vão funcionar pelo app Alexa do celular.
Por que a Alexa não consegue descobrir o meu ESP32?
Na maioria das vezes, o ESP32 e o Echo estão em redes diferentes, por exemplo uma rede de convidados ou uma banda de 5 GHz que o ESP32 não consegue usar. Confira também se outro servidor web está ocupando a porta 80 e se chamadas longas de delay estão travando o loop(). Depois de renomear um dispositivo, apague as entradas antigas no app e faça a descoberta de novo.
O Espalexa funciona com o Google Home?
Não. O Espalexa imita o suporte local da Alexa ao Philips Hue, e o Google Home não usa esse método. Para o Google Home, você precisa de um caminho como o Sinric Pro, o Home Assistant ou o Matter.
Espalexa ou FauxmoESP: qual devo usar?
Os dois registram o ESP como um dispositivo local na Alexa. O Espalexa oferece suporte a luzes dimerizáveis e coloridas e roda sobre o servidor web padrão, enquanto o FauxmoESP precisa de bibliotecas assíncronas como a AsyncTCP. Se você está começando, o Espalexa é mais fácil de configurar.
O que eu preciso para usar o Sinric Pro com um ESP32?
Uma conta no Sinric Pro, o ID do dispositivo que você criou e o APP KEY e o APP SECRET da sua conta. A placa precisa ficar online, porque os comandos chegam pela nuvem. Os planos e os limites de dispositivos podem mudar com o tempo, então confira as condições atuais ao se cadastrar.
É seguro acionar uma lâmpada da rede elétrica com um ESP32 e a Alexa?
Tecnicamente, um módulo relé dá conta, mas a tensão da rede elétrica oferece risco de morte. Monte tudo em uma caixa fechada, isolada e com fusível, e consulte um eletricista se não tiver certeza. Sempre teste antes com uma carga de baixa tensão.
Projetos para montar depois desta leitura
Ver todos os projetos
LED piscando com ESP32
Ensina o uso básico de uma saída GPIO no ESP32. Fazemos um LED piscar ligando e desligando um pino digital. É a versão para ESP32 do clássico projeto blink do Arduino UNO: os comandos básicos de blink no ambiente Arduino são os mesmos, mas a disposição dos pinos e os níveis de 3,3 V dos GPIOs do ESP32 diferem dos do Arduino UNO.

LED integrado do ESP32 piscando
Faça o LED azul integrado do ESP32 DevKit V1 piscar. Nenhum componente externo é necessário! O primeiro projeto para experimentar ao comprar um ESP32. GPIO 2 está conectado ao LED integrado.

Conexão Wi-Fi STA com ESP32 e display LCD
Neste projeto, conectamos o ESP32 à rede Wi-Fi de casa no modo estação (STA), de forma segura e tolerante a falhas. Guardamos o SSID e a senha em um arquivo secrets.h separado para evitar que sejam expostos no Git, configuramos um mecanismo de reconexão automática e exibimos o nível de sinal RSSI e o endereço IP em um display LCD I2C. O LED integrado funciona como indicador de status. É um gerenciador de conexão pronto para uso em produção.

Servidor web assíncrono com ESP32 (IP no LCD)
Neste projeto, transformamos o ESP32 em um servidor web assíncrono que você pode controlar pelo celular ou computador na mesma rede Wi-Fi. Com a biblioteca ESPAsyncWebServer, o servidor processa várias requisições ao mesmo tempo (ao contrário do WebServer.h tradicional, que bloqueia a execução ao processar uma requisição). Você poderá abrir o endereço IP do ESP32 no navegador e clicar nos botões ON/OFF (as rotas /on e /off) para ligar e desligar o LED conectado ao GPIO 5.

ESP32 mDNS: acesso via bluegrays-esp.local (com display LCD)
Neste projeto, adicionamos o serviço mDNS (Multicast DNS) ao ESP32 para acessar o dispositivo por um nome de host fácil de ler, como bluegrays-esp.local, em vez de um endereço IP. Mesmo que o IP atribuído pelo DHCP mude, você pode acessar o dispositivo pelo mesmo nome. Também executamos um pequeno servidor web no dispositivo para enviar comandos de controle do LED pelo navegador no endereço http://bluegrays-esp.local/.

Atualização OTA no ESP32 — firmware sem fio (com display LCD)
Neste projeto, você aprende a carregar um novo firmware no ESP32 por Wi-Fi, sem cabo USB. Com a biblioteca ArduinoOTA, o ESP32 fica visível na rede e aparece automaticamente como bluegrays-ota na aba "Porta de rede" do Arduino IDE. A primeira carga é feita por USB, e todas as atualizações seguintes são sem fio — um recurso essencial para dispositivos em campo. O LCD I2C mostra o estado do Wi-Fi, o IP, o nome do host, a porcentagem de envio por OTA e as mensagens de erro em turco e inglês.

Iluminação inteligente com ESP32 (PIR + LDR + relé + OLED)
Transforme a iluminação do corredor, banheiro ou despensa em iluminação inteligente com ESP32! Com um sensor de movimento PIR, um sensor de luz LDR e um módulo relé, montamos o cenário clássico de "acender a luz ao detectar movimento no escuro" — se o ambiente já estiver claro, o movimento NÃO aciona a luz, economizando energia durante o dia. A luz fica acesa por 30 segundos; se o movimento continuar, o temporizador reinicia e a luz permanece acesa por mais tempo.

Controle de fita WS2812B NeoPixel com ESP32
Os LEDs endereçáveis WS2812B (NeoPixel) são LEDs RGB inteligentes que podem ser controlados em cadeia por um único pino de dados. Neste projeto, vamos controlar uma fita WS2812B de 8 LEDs com a biblioteca Adafruit_NeoPixel para criar uma animação suave de arco-íris. Embora o nível lógico de 3,3V do ESP32 funcione sem problemas na maioria dos lotes de WS2812B, vamos mostrar uma solução com um resistor de 470Ω em série e um capacitor de 1.000µF para casos de instabilidade.
Mais artigos
App BlueGrays
Monte este circuito passo a passo pelo celular
Esquema do circuito, código e lista de componentes em uma só tela. Mais de 500 projetos com Arduino, ESP32 e Pico prontos para montar.
Escaneie com seu celular
Aponte a câmera para o código para abrir a loja de aplicativos do seu celular.
ou abrir a loja

