API de redes sociais em white-label: adicione publicações, comentários e DMs ao seu SaaS, com a sua marca
O Partner API da easyCoexistence permite a um SaaS acrescentar publicações e respostas a comentários e DMs ao seu próprio produto, com o seu nome na página de ligação. Os clientes ligam as contas numa página alojada que mostra o seu nome, o seu backend publica com POST /channels/{id}/posts, e os comentários e DMs chegam ao seu webhook para que o seu produto responda através da API de cada rede. Os ecrãs de início de sessão das redes e uma nota de rodapé nessa página ainda citam a easyCoexistence.
O nome mais longo que partner_name pode mostrar na página de ligação alojada; por omissão, aparece o nome da sua conta.
Com quanta antecedência POST /channels/{id}/posts pode agendar uma publicação, com publish_at pelo menos 1 minuto a partir de agora.
A janela de mensagens predefinida do Instagram após a mensagem de uma pessoa, para a maioria das ações do utilizador; a pessoa tem de escrever primeiro.
Quanto tempo depois de um comentário uma conta do Instagram pode enviar a sua única resposta privada a quem o escreveu.
O que pode um SaaS colocar com a sua própria marca?
Tudo o que os seus clientes usam no dia a dia. O seu editor de publicações, a caixa de entrada e os alertas são ecrãs próprios, construídos sobre a sua chave ec_live_ e as credenciais de rede que esta obtém, e os seus clientes nunca criam uma conta na easyCoexistence. Cada parte corresponde a uma parte da Partner API:
O que vê o cliente, e onde aparece a easyCoexistence?
A página de ligação alojada tem o seu nome e nenhum logótipo da easyCoexistence. Quatro elementos ainda citam a easyCoexistence, porque uma rede mostra sempre a aplicação que pede acesso, e um cliente não deve encontrar esse nome sem explicação:
- O pop-up Embedded Signup da Meta para um número do WhatsApp, que mostra a aplicação que pede acesso e não pode ser renomeado.
- O ecrã de consentimento do Instagram, Facebook, TikTok, YouTube ou LinkedIn, que nomeia a aplicação da easyCoexistence.
- Uma nota de rodapé na página alojada, que explica esse nome antes de a rede o mostrar.
- O endereço da página alojada, que está em easycoexistence.com.
Como funciona a publicação a partir do seu próprio editor?
O seu editor envia um pedido por canal para POST /channels/{id}/posts, com o texto, os conteúdos multimédia como ligações HTTPS ou valores media_id de POST /media, e publish_at para agendar mais tarde. As regras de cada rede são verificadas antes de qualquer coisa entrar na fila, por isso uma publicação que o Instagram ou o TikTok recusariam volta de imediato com o motivo. Envie um cabeçalho Idempotency-Key e um pedido repetido devolve a mesma publicação, em vez de publicar duas vezes. As publicações no LinkedIn saem quando uma pessoa no seu produto aprova cada uma.
curl -X POST https://easycoexistence.com/api/v1/channels/$CHANNEL_ID/posts \
-H "Authorization: Bearer $EC_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: post_8812" \
-d '{
"text": "Our autumn menu starts Friday.",
"media": [{ "url": "https://cdn.example.com/menu.jpg", "type": "image" }],
"publish_at": "2026-11-07T09:00:00-03:00"
}'Como chegam os comentários e as DMs ao seu produto?
Por webhook, com um destino por conta. PUT /channels/{id}/webhook aponta uma conta social para o seu endpoint e devolve um segredo de assinatura para essa conta, e a easyCoexistence encaminha cada evento assim que chega, assinado com X-EC-Signature e sem guardar qualquer cópia. O Instagram envia comentários, menções e DMs, as Páginas do Facebook enviam eventos de feed, Messenger e menções, e o TikTok envia comment.update. As mensagens de um número do WhatsApp vão diretamente da Meta para o seu webhook_url.
Como responde o seu produto?
Através da API de cada rede, com o token de GET /channels/{id}?credentials=1, para que a resposta leve a conta do cliente como autora. As chamadas que o seu botão Responder faz:
- Comentário no Instagram: POST /<
IG_COMMENT_ID>/replies com o campo message. - DM no Instagram: POST /<
IG_ID>/messages com o ID da pessoa e o texto, dentro de 24 horas da última mensagem dela. - Resposta privada a um comentário no Instagram: o mesmo edge com o recipient
comment_id, uma vez por comentário, dentro de 7 dias após este. - Comentário no TikTok: business/comment/reply/create/, que publica uma resposta pública.
- WhatsApp: o
send_endpointdo número, com o token de negócio do próprio cliente.
Erros comuns
- Prometer aos clientes o seu nome dentro do pop-up da Meta. A Meta mostra a aplicação que pede acesso, que é a da easyCoexistence, por isso diga aos clientes o que vão ver antes de ligarem a conta.
- Oferecer um botão Responder em DMs do Instagram com mais de 24 horas. A janela já fechou, por isso verifique a hora da última mensagem da pessoa antes de o seu produto deixar alguém responder.
- Publicar no LinkedIn a partir de um agendamento que ninguém revê. Os termos da API do LinkedIn restringem a publicação automatizada, por isso faça uma pessoa aprovar cada publicação no LinkedIn antes de o seu produto a enviar.
- Verificar os eventos de todos os canais com um único segredo. Cada conta social assina os eventos que encaminha com o seu próprio segredo, devolvido uma vez por PUT /channels/{id}/webhook.
A easyCoexistence coloca a publicação e as respostas a comentários e DMs dentro do seu produto, nos números do WhatsApp dos seus clientes e nas contas do Instagram, Facebook, TikTok, YouTube e LinkedIn deles, e em mais canais, através da API oficial de cada rede, com o seu nome na página de ligação e cada ligação monitorizada 24 horas por dia. De US$ 9 a US$ 0,75 por ligação por mês, descendo à medida que acrescenta ligações, com os primeiros 3 dias grátis.
Perguntas frequentes
A página de ligação alojada pode funcionar no meu próprio domínio?
Não. Funciona em easycoexistence.com e mostra o seu nome a partir de partner_name. Os clientes chegam a ela através de um redirecionamento ou de um novo separador a partir da sua aplicação e voltam ao seu redirect_url quando terminam.
Os meus clientes precisam de uma conta na easyCoexistence?
Não. Abrem a ligação que a sua aplicação lhes dá, iniciam sessão com a rede e voltam à sua aplicação. Cada ligação pertence à sua conta e é faturada nela.
Os meus clientes podem continuar a usar as aplicações próprias das redes?
Sim. Ligar acrescenta acesso à API para o seu produto; a conta continua a funcionar no Instagram, no TikTok e nas outras aplicações, e um número do WhatsApp continua na aplicação do WhatsApp Business através da Coexistence.
Quanto custa a easyCoexistence dentro do seu próprio produto?
Cada conta ligada custa de US$ 9 a US$ 0,75 por mês, conforme a faixa do seu total de contas, e os primeiros 3 dias são grátis. Fica a seu cargo o preço cobrado aos seus clientes.
Continue a ler
Ligue o seu primeiro canal em dois minutos.
Sem revisões de plataformas para esperar. Ligue o WhatsApp, o Instagram, o TikTok ou outro canal, peça depois à sua IA que publique, responda ou faça um relatório, e veja-a trabalhar.
- 3 dias grátis
- Cancele quando quiser
- Só APIs oficiais
- Monitorizado 24/7
Verificado em