API de redes sociais unificada para SaaS: uma integração para WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn e mais canais
A API de Parceiros da easyCoexistence dá a um SaaS uma integração para o WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn e mais canais dos seus clientes. Uma chave de API e uma chamada de sessão de ligação ligam-nos; as mesmas chamadas listam-nos, devolvem credenciais atualizadas, definem webhooks e enviam eventos de estado assinados, e um único endpoint de publicações publica no Instagram, Facebook, TikTok e LinkedIn. As respostas passam pela API própria de cada rede, com o token do cliente.
Chaves da API de Parceiros por conta da easyCoexistence; cada número e cada conta social que ela liga pertence a essa conta.
Preço mensal por ligação, igual para um número de WhatsApp e para uma conta social, e que desce à medida que a quantidade cresce.
Publicações por API que uma conta do Instagram pode fazer em qualquer período móvel de 24 horas; um carrossel conta como uma.
Publicações de vídeo que o TikTok publica por conta através da sua API, no máximo seis por minuto.
Janela de apoio ao cliente do WhatsApp após a mensagem de um utilizador; quando fecha, só podem ser enviados templates aprovados.
O que cobre uma só integração?
O trabalho que é igual em todas as redes, a partir de https://easycoexistence.com/api/v1 com uma chave ec_live_. O seu código aprende estas chamadas uma só vez, e a conta TikTok de um cliente é tratada como a conta do Instagram, com os mesmos erros, os mesmos IDs e os mesmos eventos assinados:
O que cada rede ainda decide?
O que a sua API permite. A easyCoexistence liga, renova e acompanha cada conta da mesma forma, mas as funcionalidades que o seu produto pode oferecer seguem as regras próprias de cada rede, pelo que as mensagens diretas (DM), os eventos de comentários e os tipos de publicação diferem de uma rede para a outra:
Porque são os números e as contas sociais recursos separados?
Porque guardam coisas diferentes. Um número tem um telefone, uma WhatsApp Business Account e as classificações de qualidade da Meta; uma conta social tem um nome de utilizador e um ID de rede. Por isso, os números vivem em /connections e as contas sociais em /channels, cada um com os seus próprios IDs, o seu próprio parâmetro de redirecionamento, connection_id ou channel_id, e os seus próprios nomes de eventos. Uma integração só para WhatsApp nunca encontra um canal, a menos que o peça, e ligar é a única chamada que partilham.
Como funciona uma chamada de publicação em várias redes?
O corpo do pedido é igual em todo o lado: text, media, link e publish_at, mais alguns campos que uma rede lê, como ig_type no Instagram, title e disable_comment no TikTok e image_alt no LinkedIn. Os limites de cada rede são verificados antes de a publicação ser colocada na fila:
- Instagram: uma imagem ou um vídeo, ou um carrossel de 2 a 10; imagens JPEG; sem campo link; texto até 2,200 caracteres.
- Facebook: texto, um link, uma imagem ou um vídeo; texto até 63,206 caracteres.
- TikTok: um vídeo, ou uma publicação de fotos com 1 a 35 imagens JPEG ou WebP; sem link; texto até 2,200 caracteres.
- LinkedIn: texto com uma imagem ou um link, que exige um título; sem vídeo; texto até 3,000 caracteres.
A easyCoexistence fica entre o seu código e as redes?
Só onde isso lhe poupa trabalho: ligar, renovar tokens, encaminhar os eventos de comentários e de mensagens diretas e gerir a fila de publicações. As respostas, as leituras e tudo o resto vão do seu backend diretamente para a API da rede, com o token do cliente, e a Meta entrega as mensagens de um número diretamente ao seu servidor. Uma funcionalidade que uma rede acrescente fica acessível a partir do seu código assim que a rede a lançar, sem esperar por uma camada intermédia.
O que acontece quando entra uma nova rede?
Chega como um novo valor de canal nas mesmas chamadas. As suas sessões de ligação indicam-na, as suas contas aparecem em GET /channels, os seus eventos usam os nomes channel.* e cada conta custa o mesmo que qualquer outra ligação. Um canal que a sua conta ainda não pode usar responde com 400 channel_unavailable, e a mensagem enumera os canais abertos a essa conta.
Como configurar
- Create a keyIn the dashboard under Profile, Developers, create the ec_live_ key and store it in your backend's secrets.
- Save a cardAdd a card to the account, since connect sessions answer 402 billing_required until one is saved.
- Connect each customerCreate a connect session with the channel and your customer's id as external_ref, and send the customer to its url.
- Set the webhooksGive each number a webhook_url and each social account a destination with PUT /channels/{id}/webhook.
- Post and replyPublish with POST /channels/{id}/posts and reply through each network's API with fresh credentials.
Erros comuns
- Construir mensagens diretas (DM) para TikTok, YouTube ou LinkedIn. Essas ligações não têm mensagens diretas, por isso planeie aí as respostas a comentários, e as respostas a mensagens diretas para WhatsApp, Instagram e Messenger.
- Enviar uma publicação no Instagram sem conteúdo multimédia. O Instagram exige uma imagem ou um vídeo, e o pedido é recusado antes de entrar na fila, por isso anexe o conteúdo multimédia a cada rede.
- Guardar channel_id e connection_id numa só coluna sem indicar o tipo. São recursos separados com IDs separados, por isso registe a que tipo pertence cada valor.
- Publicar no LinkedIn a partir de um feed sem revisão. Os termos da API do LinkedIn restringem a publicação automatizada, por isso peça a uma pessoa que aprove cada publicação no LinkedIn antes.
A easyCoexistence dá ao seu SaaS uma integração para os números de WhatsApp dos seus clientes e para as contas do Instagram, Facebook, TikTok, YouTube e LinkedIn deles, e mais canais: links de ligação, credenciais, webhooks, eventos de estado e publicações em cada rede, através da API oficial de cada uma, com cada ligação monitorizada 24 horas por dia. De US$ 9 a US$ 0.75 por ligação ao mês, descendo à medida que acrescenta ligações, com os primeiros 3 dias gratuitos.
Perguntas frequentes
Um só endpoint pode receber eventos de todas as redes?
Sim. Aponte o destino de cada canal para o mesmo URL e encaminhe com base em platform e account_id no corpo do pedido. As mensagens de um número de WhatsApp vêm da Meta para o seu próprio webhook_url, que pode ser o mesmo servidor.
Tenho de registar a minha própria app na Meta, no TikTok, na Google e no LinkedIn?
Não. Os clientes iniciam sessão através das apps da easyCoexistence nessas redes, e o seu backend recebe o token de que precisa para chamar a API de cada rede.
Para que redes publica o endpoint de publicações?
Instagram, Páginas do Facebook, TikTok e LinkedIn. Os vídeos do YouTube são carregados pela API própria do YouTube, com as credenciais do canal.
Quanto custa a API unificada da easyCoexistence?
O mesmo em todas as redes: de US$ 9 a US$ 0.75 por ligação ao mês, definido pelo escalão do total de ligações, com os primeiros 3 dias gratuitos.
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