API multi-tenant de redes sociais: uma chave de API, muitas contas de clientes
A Partner API da easyCoexistence é multi-tenant por design: uma chave ec_live_ na sua conta conecta e gerencia os números de WhatsApp e as contas de redes sociais de muitos clientes. Cada conexão leva o id do seu cliente como external_ref, guarda o token próprio desse cliente, tem o seu próprio destino de webhook e aparece nos eventos de status assinados, para que GET /channels?external_ref= liste as contas de um único cliente.
Tamanho máximo do external_ref aceito por uma sessão de conexão: o id do seu cliente, guardado na conexão que ela cria.
Chaves de API que uma conta da easyCoexistence pode ter ao mesmo tempo; chaves separadas significam contas separadas, com cobranças separadas.
Sessões de conexão que uma conta pode manter abertas ao mesmo tempo, junto com um limite de 100 novas sessões por hora.
Idade a partir da qual o timestamp de um evento assinado deve ser rejeitado, com o HMAC comparado em tempo constante.
Como uma conta atende muitos clientes?
Sua conta na easyCoexistence representa o seu produto, e cada cliente é uma marcação nas conexões que ele traz. Os clientes não criam conta própria, nunca veem a sua chave e são cobrados por você, não pela easyCoexistence:
Como marcar cada conexão com o seu cliente?
Envie external_ref na sessão de conexão. O valor é guardado no número ou canal que a sessão cria, incluído no redirecionamento e nos seus eventos de status. Um login do Facebook ou do LinkedIn que traz várias Páginas marca cada uma delas. Para ver as contas de um cliente, filtre qualquer uma das listas:
curl "https://easycoexistence.com/api/v1/channels?external_ref=customer_4821" \
-H "Authorization: Bearer $EC_API_KEY"
curl "https://easycoexistence.com/api/v1/connections?external_ref=customer_4821" \
-H "Authorization: Bearer $EC_API_KEY"Como os tokens dos clientes ficam separados?
Cada conexão guarda o token do próprio cliente. O token de um número de WhatsApp é o token de negócio que a Meta emite no Embedded Signup, restrito aos ativos desse cliente, e o token de uma conta de rede social é o que o dono concedeu. As credenciais saem apenas pela sua chave, a partir do seu backend, e um ID que não está na sua conta responde 404 not_found. Consulte a conexão do cliente a que uma tarefa pertence antes de buscar o seu token, para que o trabalho de um cliente nunca rode na conta de outro.
Como funcionam os webhooks por cliente?
Um destino por conta, escolhido por você. Aponte os canais para uma única URL e roteie pelo account_id no corpo, ou dê a cada cliente uma URL própria. Cada canal assina com o seu próprio segredo, definido em PUT /channels/{id}/webhook, então o account_id indica qual segredo usar na verificação. As mensagens de um número vão da Meta para o seu webhook_url, configurado na WhatsApp Business Account, por isso roteie essas pelo phone_number_id.
Como os eventos de status informam a qual cliente se referem?
Trazendo o seu external_ref. Uma URL de eventos por conta recebe os eventos connection.* e channel.*, cada um com a visão da conexão ou do canal dentro, incluindo o external_ref, e post.published e post.failed trazem a publicação e o seu canal. Os eventos são assinados com o segredo da conta no cabeçalho X-EC-Signature e repetidos quando o seu endpoint falha, então trate cada id de entrega uma única vez.
Com que rapidez você integra muitos clientes?
Com 50 sessões de conexão abertas e 100 novas por hora por conta. A Meta conta cada onboarding inicial do WhatsApp contra um limite de todo o app, que todas as contas da easyCoexistence compartilham, e os limites impedem que a importação de uma plataforma esgote esse limite. Crie cada sessão quando o cliente estiver prestes a se conectar. Ao atingir um limite, a resposta é 429 cap_reached ou rate_limited.
E se a conta de um cliente já estiver conectada em outro lugar?
O login é recusado. Uma conta de rede social se conecta por meio de uma conta da easyCoexistence por vez, então, se outro serviço que usa a easyCoexistence a tiver, o last_error da sessão informa isso e o cliente a remove por lá ou entra com outra conta. Dentro da sua própria conta, um cliente pode conectar quantas contas precisar, todas marcadas com o mesmo external_ref.
Como você remove um cliente?
Liste as conexões e os canais dele por external_ref e faça DELETE em cada um. Remover um número revoga o acesso da easyCoexistence na Meta e interrompe o monitoramento; remover um canal revoga o acesso na rede e cancela as publicações dele que ainda estão na fila. A cobrança de cada um para ao fim do ciclo, e as demais conexões do cliente, assim como as de outros clientes, não são afetadas.
Erros comuns
- Usar um e-mail como external_ref. E-mails mudam, e o valor fica guardado em cada conexão, então use o id estável do seu próprio banco de dados.
- Verificar eventos encaminhados com o segredo de outro cliente. Busque o segredo pelo account_id no corpo, já que cada canal assina com o seu próprio.
- Enviar links de conexão para toda a sua base de clientes de uma vez. Só 50 sessões podem estar abertas por conta, então convide os clientes em lotes.
- Excluir um cliente apenas no seu próprio banco de dados. As conexões dele continuam na sua conta e na sua fatura até que cada uma seja removida pela API.
A easyCoexistence permite que uma chave de API atenda toda a sua base de clientes: os números de WhatsApp deles e as contas de Instagram, Facebook, TikTok, YouTube e LinkedIn, além de outros canais que chegarem, cada um marcado com o id do seu cliente, com token, webhook e eventos assinados próprios, e cada conexão monitorada 24/7. De US$ 9 até US$ 0.75 por conexão ao mês, caindo conforme você adiciona conexões, com os primeiros 3 dias grátis.
O easyCoexistence é uma API e um servidor MCP multicanal que conecta agentes de IA, como o Claude e o ChatGPT, ao WhatsApp, Instagram, TikTok, Facebook e mais. No WhatsApp, ele usa o Coexistence: a empresa continua usando o número no app WhatsApp Business enquanto a IA trabalha pela API oficial da Meta.
Perguntas frequentes
Preciso de uma conta da easyCoexistence por cliente?
Não. Uma conta e a sua chave podem manter as conexões de muitos clientes, diferenciadas pelo external_ref. Contas separadas só são necessárias quando você quer cobranças separadas.
Meus clientes podem ver as contas uns dos outros?
Não pela easyCoexistence. Eles nunca têm a sua chave e abrem apenas os próprios links de conexão. O que cada cliente vê dentro do seu produto é definido pelo seu código.
Posso dar a cada cliente uma URL de webhook diferente?
Sim. Cada número e cada canal aceita o seu próprio destino, então uma URL específica por cliente funciona, assim como uma URL compartilhada roteada pelo account_id.
Como uma conta com vários clientes é cobrada?
Por conexão, somando todos os seus clientes: de US$ 9 até US$ 0.75 por conexão ao mês, definido pela faixa do total de conexões, com os primeiros 3 dias grátis.
Continue lendo
Conecte seu primeiro canal em dois minutos.
Sem esperar aprovação das plataformas. Conecte o WhatsApp, o Instagram, o TikTok ou outro canal, peça para a sua IA publicar, responder ou trazer os números, e veja funcionando.
- 3 dias grátis
- Cancele quando quiser
- Só APIs oficiais
- Monitorado 24/7
Verificado em