Iniciar sessãoIniciar teste gratuito

Partner API para plataformas SaaS: ligue os canais dos seus clientes

A Partner API da easyCoexistence permite que o seu software ligue os números de WhatsApp dos seus clientes e as respetivas contas de Instagram, Facebook, TikTok, YouTube e LinkedIn, entre outros canais, através de um link de ligação alojado. O seu backend recebe depois as credenciais de cada ligação, encaminha as mensagens e os comentários para o seu webhook e é avisado quando uma ligação cai, tudo através da API oficial de cada rede, a US$ 9 a US$ 0.75 por ligação.

  • Um link de ligação alojado, ao estilo do Stripe Checkout
  • Credenciais, webhooks e eventos por ligação
  • US$ 9 a US$ 0.75 por ligação, 3 dias grátis

Referência rápida

URL base
https://easycoexistence.com/api/v1
Autenticação
Authorization: Bearer ec_live_…, uma chave por conta
Ligar
POST /connect-sessions, com channel para uma conta de rede social
Números
GET /connections, e /connections/:id
Contas de redes sociais
GET /channels, e /channels/:id
Credenciais
?credentials=1 numa ligação ou num canal
Webhooks
PUT /connections/:id/webhook ou /channels/:id/webhook
Eventos
connection.* e channel.*, assinados, com novas tentativas durante cerca de 33 horas

Ligue os seus clientes em três passos

  1. 1Crie uma chave de APINo painel, em Perfil e depois Programadores, ou peça ao seu assistente que execute create_api_key. Uma chave por conta, mostrada uma única vez.
  2. 2Envie o seu cliente para um link de ligaçãoO seu backend cria uma sessão; o seu cliente inicia sessão na rede a partir de uma página alojada e regressa ao seu URL de redirecionamento.
  3. 3Utilize a ligaçãoObtenha as respetivas credenciais, aponte o webhook para o seu sistema e trate os eventos assinados que indicam quando a ligação é estabelecida ou cai.
curl https://easycoexistence.com/api/v1/connect-sessions \ -H "Authorization: Bearer ec_live_…" \ -H "Content-Type: application/json" \ -d '{"channel":"instagram","redirect_url":"https://app.example.com/return","external_ref":"customer_4821"}'

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

Guias para plataformas

Cada parte da construção sobre a Partner API, desde o link de ligação até aos eventos que indicam que uma ligação caiu.

A referência completa

Todos os endpoints, campos e eventos, com os corpos dos pedidos e das respostas: referência da Partner API.

Perguntas frequentes

Os meus clientes precisam de uma conta easyCoexistence?

Não. Abrem uma página alojada, iniciam sessão na rede e regressam à sua app, sem conta, email nem cartão. Todas as ligações feitas através da sua chave pertencem à sua conta.

Quem paga as ligações dos meus clientes?

A sua conta, por ligação e igual em todas as redes: de US$ 9 a US$ 0.75 por ligação por mês, a descer à medida que adiciona ligações, com os primeiros 3 dias grátis. No WhatsApp, a Meta cobra os seus próprios custos à WhatsApp Business Account do cliente.

As mensagens passam pela easyCoexistence?

No WhatsApp, não: a Meta entrega as mensagens de um número diretamente no webhook que definiu. Os comentários e as DMs das redes sociais são reencaminhados para o seu endpoint à medida que chegam, assinados por conta, sem que seja guardada qualquer cópia.

A página de ligação pode ter a minha marca?

A página alojada apresenta o seu nome, para um número ou uma conta de rede social. O início de sessão da própria rede, como o popup da Meta, indica a easyCoexistence como a app que pede acesso, e isso não pode ser alterado.