Ligar canais

O ContentFlows publica automaticamente nos seus canais sociais assim que os liga. Cada canal precisa de two values: um token de acesso (o que concede permissão) e um ID (para qual conta / página / canal publicar). Ambos são colados no seu painel e armazenados encriptados no AWS Secrets Manager, isolados na sua conta.

Onde ligar

No seu painel de administração, vá ao separador Integrations. Verá um cartão para cada canal suportado com campos de introdução para cada valor que essa plataforma precisa. Preencha-os e clique em Save.

Configuração única por canal

Só precisa de fazer isto uma vez por plataforma. O ContentFlows usa os valores guardados para todas as publicações futuras até o token expirar ou ser substituído.

O ContentFlows publica através da LinkedIn UGC Posts API. Precisa de two fields:

Access token (LINKEDIN_ACCESS_TOKEN) — token OAuth 2.0 com o âmbito w_member_social.
Member URN (LINKEDIN_AUTHOR_ID) — identifica sob que perfil ou Company Page as publicações aparecem; começa por urn:li:person: ou urn:li:organization:.

Guia passo a passo: Obter um token e URN do LinkedIn →

Expiração do token

Os tokens de acesso do LinkedIn expiram a cada 60 days. O URN é permanente — só precisa de regenerar o token.

Facebook

O ContentFlows publica numa Facebook Page (não num perfil pessoal). Precisa de two fields:

Page access token (FB_PAGE_ACCESS_TOKEN) — tem de incluir o âmbito pages_manage_posts (o que mais frequentemente é esquecido). Quando é derivado de um token de utilizador de longa duração, os tokens de Page nunca expiram.
Page ID (FB_PAGE_ID) — o ID numérico da Page (por exemplo, 123456789012345), NÃO o nome de utilizador legível.

Tem de ser Admin da Page.

Guia passo a passo: Obter o token e o ID da Facebook Page →

Instagram

A publicação no Instagram requer uma Professional account (Business ou Creator) ligada a uma Facebook Page. Contas pessoais do Instagram não podem ser usadas para publicação via API.

Access token (IG_ACCESS_TOKEN) — opcional. Deixe em branco para reutilizar o token da Facebook Page que já configurou.
Business Account ID (IG_BUSINESS_ACCOUNT_ID) — ID numérico da Instagram Business Account ligada à sua Facebook Page (por exemplo, 17841412345678901).

Guia passo a passo: Obter o Instagram Business Account ID →

Converter para uma Professional account

Na aplicação Instagram: vá a Settings → Account → Switch to Professional Account. Escolha Business ou Creator. Depois ligue à sua Facebook Page em Settings → Account → Linked Accounts.

YouTube

O ContentFlows usa a YouTube Data API v3 para gerar metadados (títulos, descrições, tags) para o seu calendário de conteúdo.

API key (YOUTUBE_API_KEY) — da Google Cloud Console com a YouTube Data API v3 ativada.
Channel ID (YOUTUBE_CHANNEL_ID) — o ID único do seu canal (começa com UC), encontrado em YouTube Studio → Settings → Channel → Advanced settings.

Guia passo a passo: Obter a API key e o Channel ID do YouTube →

Email newsletter

O ContentFlows envia newsletters via Amazon SES para a sua lista de subscritores por tenant. Não é necessário token — é configurado quando a sua conta é provisionada.

Gerir subscritores

O separador Newsletter no seu painel tem um painel completo de subscritores com:

Stats header — contagens de ativos / pendentes / cancelados / devolvidos / queixosos
Import — carregamento CSV, Mailchimp API key ou ConvertKit API key
List view — pesquisa, filtrar por estado, eliminar por linha, eliminação em massa, exportação CSV
Re-subscribe — voltar a adicionar um contacto cancelado ou devolvido

O seu URL público de registo é https://YOUR-SLUG.contentflows.cc/subscribe, em que YOUR-SLUG é o identificador seguro para DNS definido no seu tenant (predefinição: uma versão limpa do nome da sua empresa). Os registos usam double opt-in (email de confirmação); as importações CSV / Mailchimp / ConvertKit ignoram a verificação porque declara consentimento no carregamento.

Configuração DNS única (apenas operador)

Para a página de registo do subdomínio resolver para qualquer tenant, o operador da plataforma precisa de configurar o DNS wildcard uma vez: *.contentflows.cc como um CNAME a apontar para a origem que estiver a servir o site raiz contentflows.cc. Até isso estar em vigor, o URL de fallback https://contentflows.cc/subscribe?tenant=YOUR-SLUG funciona em todo o lado.

As ligações de cancelamento de subscrição são assinadas com HMAC-SHA256 e incorporadas em todas as newsletters enviadas (o cabeçalho RFC-8058 List-Unsubscribe-Post está incluído para conformidade de um clique com Gmail / Yahoo).

Domínio de envio (DKIM + SPF + DMARC)

Por predefinição, os emails são enviados de noreply@contentflows.cc. Para uma entregabilidade muito melhor, autentique o seu próprio domínio para que as newsletters sejam enviadas de newsletter@your-business.com.

Abra o separador Brand, encontre o cartão Sending domain, escreva o seu domínio, copie os 5 registos DNS que aparecem, cole-os no seu fornecedor de DNS e clique em Verify. O cartão consulta o SES durante 10 minutes até o DKIM + DMARC serem validados.

Quais são os 5 registos

3 × CNAME para assinatura DKIM (tokens gerados pelo SES)
1 × TXT no domínio raiz para SPF (v=spf1 include:amazonses.com -all)
1 × TXT em _dmarc.your-domain.com para DMARC (v=DMARC1; p=none; rua=mailto:dmarc@your-domain.com)

Como as credenciais são armazenadas

Todos os campos de todas as plataformas para o seu tenant são guardados como um único blob JSON encriptado no AWS Secrets Manager em contentflows/tenants/YOUR_TENANT_ID/social-tokens. Os segredos nunca são registados, nunca voltam a ser mostrados depois de guardados e ficam isolados na sua conta. O ContentFlows nunca armazena a sua palavra-passe das redes sociais.

Substituir um valor

Para atualizar um token ou um ID (por exemplo, após expiração do token), vá ao separador Integrations, cole o(s) novo(s) valor(es) nos campos relevantes e clique em Save. Apenas os campos que alterar são atualizados — o resto do blob mantém-se intacto.

O que acontece depois de ligar

Assim que um canal estiver ligado, o ContentFlows publica automaticamente o conteúdo aprovado no seu horário. Reveja e aprove cada peça no separador Content Queue antes de ficar disponível.

Canais suportados

LinkedIn — publicações pessoais ou de Company Page (UGC Posts API)
Facebook — publicações de Page (Graph API)
Instagram — publicações do feed em contas Professional (Graph API)
YouTube — pesquisas de metadados (Data API v3)
Email newsletter — via Amazon SES (configurado automaticamente)