Whitelabel¶

O que é Whitelabel?¶

Whitelabel é uma customização completa da experiência iFriend para que uma empresa ofereça o serviço como se fosse próprio.

Diferença entre Affiliate e Whitelabel¶

Aspecto	Affiliate	Whitelabel
Marca	Própria marca no footer	Marca completa (logo, cores, domínio)
Domínio	Domínio iFriend	Domínio próprio (agents.seusite.com)
Customização	Básica (logo + cores)	Completa (UI, fluxos, textos)
Custos	Receita compartilhada	Fee mensal fixo

Configuração de Whitelabel¶

1. DNS Configuration¶

Configure seu DNS para apontar para a iFriend:

agents.seusite.com CNAME agents.theifriend.com

2. Configuração no Painel¶

No painel admin, configure:

{
  "domain": "agents.seusite.com",
  "company_name": "Sua Empresa",
  "logo_url": "https://seusite.com/logo.png",
  "primary_color": "#1E3A8A",
  "contact_email": "atendimento@seusite.com",
  "contact_phone": "+5521999999999",
  "whatsapp": "+5521999999999"
}

3. Variáveis de Ambiente¶

# No .env do seu deployment
WHITELABEL_ENABLED=true
WHITELABEL_DOMAIN=agents.seusite.com
WHITELABEL_BASE_URL=https://agents.seusite.com

Customizações Disponíveis¶

Branding¶

Logo (email, chat, confirmations)
Cores primárias e secundárias
Favicon
Imagens de background

Conteúdo¶

Mensagens de boas-vindas personalizadas
FAQs específicas do nicho
Respostas automáticas customizadas

Fluxos¶

Order of agents differently
Skip certain steps
Add custom validation

whitelabel_base_url no message_metadata¶

Quando o whitelabel_base_url está presente nas message_metadata:

O Agent Card usa essa URL base
Os emails incluem branding do whitelabel
Os links nos mensajes apontam para o domínio customizado
Telefones são formatados conforme a região

Exemplo de Configuração com SDK¶

from ifriend_api import IFriendClient

client = IFriendClient(api_key="your-key")

# Criar whitelabel
whitelabel = client.whitelabel.create(
    domain="agents.minhaempresa.com",
    company_name="Minha Empresa",
    logo_url="https://minhaempresa.com/logo.png",
    primary_color="#FF6B35",
    contact_email="atendimento@minhaempresa.com",
    contact_phone="+5511999999999"
)