Conectores e canais
Se a camada de dados é sobre o que uma IA pode ler e fazer dentro do seu app, esta página é sobre as pontes para fora: sincronizar com provedores externos (o Google Calendar, o Stripe) e — o que o fundador mais pergunta — atender por canais de mensagem como o WhatsApp.
Parte disso já está em produção. Parte é roadmap, e aqui a gente diz claramente qual é qual. Para a lista completa de provedores do catálogo (com o status de cada um), veja a página de Integrações.
A espinha de conectores
Existe um contrato real de conectores em @fayz-ai/core (packages/core/src/integrations): Connector e ConnectorDefinition. Um conector declara:
- Um modo de autenticação —
oauth,api-keyoumtls. - Capacidades — o que ele sabe sincronizar.
testConnectionesync— testar a credencial e puxar/empurrar dados.
Um plugin publica conectores pelo campo connectors do manifesto (o plugin vira um addon de um host). A shell traz um ConnectorsHub compartilhado nas configurações, onde o usuário conecta e gerencia provedores. O trabalho pesado de sincronização roda em Supabase Edge Functions — o plano de dados fica no backend, não no navegador.
Pense em dois planos: o control plane é a UI de /settings (conectar, testar, escolher o que sincronizar); o data plane é a edge function que faz o sync de verdade. O contrato em @fayz-ai/core costura os dois.
Dois conectores que já existem
Não é teoria — há dois POCs shipados:
No plugin-agenda: OAuth, seletor de calendário e sync de eventos. Vive em src/integrations/google-calendar. É o exemplo canônico de conector nativo de um plugin.
No plugin-courses: conector de pagamentos em src/connectors/stripe.ts. Mostra o mesmo contrato aplicado a um provedor de billing.
Os dois seguem o mesmo ConnectorDefinition — é o padrão que um plugin próprio replica para falar com qualquer provedor externo.
Canais de mensagem — e o WhatsApp
Aqui entra o que o fundador cobra: como esses produtos chegam ao WhatsApp. A resposta honesta tem duas partes — a base que já existe e o marco que ainda vem.
O que existe: o inbox omni-channel
O plugin-conversations é um inbox omni-channel experimental. O enum de canais já inclui whatsapp como rótulo, e o plugin declara as aiTools listConversations (read) e sendMessage (persist). Ou seja: a estrutura de caixa de entrada, threads e ferramentas de IA para ler e responder já está modelada.