Onboarding de Contas Sociais de Clientes

Use o MCP Server para fazer o onboarding das contas sociais de clientes sob sub-profiles com uma URL de vinculação social JWT.

Integradores no Business Plan ou Enterprise Plan podem fazer o onboarding das contas sociais dos seus clientes sob sub-profiles. Usando o MCP Server, um agente cria um sub-profile, o direciona e gera uma URL de vinculação com single sign-on que o cliente abre para conectar suas contas.

​

Fluxo

1. Crie um sub-profile

   Chame create_profile (nível de conta — sem profileKey). Ele retorna uma profile key para o novo sub-profile.

2. Direcione para o sub-profile

   Use a profile key retornada nas chamadas seguintes — seja via o header Profile-Key na conexão ou como argumento profileKey por chamada. Veja Conectar e Configurar para a precedência.

3. Gere uma URL de vinculação social

   Chame generate_jwt_social_linking_url para gerar uma URL de vinculação com single sign-on. A chave de assinatura JWT e o domínio de onboarding são derivados no servidor — o chamador não fornece headers X-Ayrshare-* nem chave privada ou domínio.

4. O cliente vincula suas contas

   O cliente abre a URL e autoriza (OAuth) suas contas sociais. As contas conectadas são vinculadas ao sub-profile.

​

Requisitos

generate_jwt_social_linking_url exige uma profileKey. Se nenhuma for resolvida, a chamada retorna 400 com a mensagem “Profile Key is required…”.

Um domínio de vinculação social deve estar provisionado para sua conta. Isso está disponível nos planos Business e Enterprise.

​

Estados de erro

Condição	Resposta
Nenhum domínio provisionado	400 — “No social-linking domain is provisioned for this account (available on Business/Enterprise plans).”
Nenhuma chave de assinatura	400 — “No signing key found for this account’s social-linking domain.”

​

Próximos passos

Conectar e Configurar

Autenticação e direcionamento de profile.

Catálogo de Tools

As 27 tools agrupadas por domínio, com escopo e propósito.