# Configure o SosoAPI para a pessoa que usa este assistente

Use o assistente existente da pessoa e mantenha a tarefa, o conteúdo e as referências originais
referências de mídia nesta conversa. Use um SosoAPI MCP para suas contas conectadas
contas sociais. Reutilize uma conexão existente ou escolha acesso local ou hospedado
abaixo. A configuração não publica posts. A pessoa faz login e escolhe o que
autorizem no navegador. Nunca insira suas credenciais nem aprove o consentimento
para eles. Free não exige cartão.

## 1. Conecte este assistente

Confira primeiro o host atual e sua configuração existente do SosoAPI. Reutilize uma
conexão funcional; não faça logout, sobrescreva a configuração nem crie outra
conexão só porque este guia foi aberto novamente.

Para um shell local, confira se Node.js 20 ou posterior e npx estão disponíveis. Use um
runtime existente compatível. Se ausente, explique o pré-requisito em linguagem simples
idioma; não faça automaticamente alterações privilegiadas ou globais no sistema.

Claude Code:

```sh
claude mcp add sosoapi -e SOSOAPI_TOOL_PROFILE=core -- npx -y sosoapi
```

Codex:

```sh
codex mcp add sosoapi --env SOSOAPI_TOOL_PROFILE=core -- npx -y sosoapi
```

Após registrar o servidor, confira se consegue chamar suas ferramentas nesta
conversa. Se o host precisar reconectar ou reiniciar, diga à pessoa qual
ação a realizar. Aguarde até as ferramentas funcionarem antes de dizer que a conexão está pronta.

Novas conexões usam o perfil core existente de 28 ferramentas para publicação comum,
mídia, comentários e insights. Uma conexão funcional com perfil full deve ser reutilizada.
Se uma operação de administração solicitada estiver ausente, explique que o perfil full
está disponível; ocultar uma ferramenta não concede nem revoga permissão.

Para um cliente apenas de navegador, como ChatGPT com suporte a apps MCP personalizados, adicione este
URL de MCP remoto e escolha OAuth com registro automático de cliente:

`https://gqeshlawtcexsapabaui.supabase.co/functions/v1/remote-mcp`

Não é necessário colar API key, client ID ou client secret. A pessoa faz login
no SosoAPI e escolhe seus Workspaces/ações. Apps personalizados do ChatGPT dependem de
seu plano e a disponibilidade do modo de desenvolvedor. Reutilize uma conexão local ou remota funcional
conexão se uma já estiver configurada.

O X aceita texto e links originais. Cada Organization compartilha 10 créditos X de Free
uma vez, ou 100 por período de cobrança Pro. Texto simples custa 1; um Post com URL
custa 10. Consulte `sosoapi_get_x_usage` com workspace_id antes de planejar o uso do X.
Não há cobrança automática por excedente; uma publicação incerta mantém seu crédito
reserva e deve ser reconciliada antes de outro envio.

## 2. Faça login sem API key

A primeira chamada MCP autenticada abre o login existente no navegador e o fluxo de agente
fluxo de consentimento. A pessoa pode usar o Google ou se cadastrar e verificar o e-mail.
Deixe que escolham seu workspace e se o assistente pode apenas preparar
conteúdo ou também pode agendar e publicar. Não peça que copiem credenciais.
O consentimento de publicação é contínuo no escopo selecionado, não uma etapa obrigatória de
tela de aprovação para cada post. Mantenha o gerenciamento de chaves desativado para publicações comuns.

O cadastro e login por e-mail usam verificação de segurança em segundo plano, sem
caixa de seleção para a pessoa resolver. Se a verificação falhar, informe o verdadeiro
erro e use a ação disponível de repetição; não peça à pessoa que encontre ou clique
uma caixa CAPTCHA. A opção existente **Continuar com Google** também está disponível
se a pessoa quiser usar o Google; o Google pode exigir sua própria verificação de identidade.
Deixe a pessoa escolher a conta e aprovar o acesso.
Mantenha o link atual de login/aprovação e seu destino de retorno; não substitua
por uma simples URL de cadastro nem troque silenciosamente para uma identidade existente de mantenedor.
Um erro de login não comprova que todos os métodos de login estejam indisponíveis.

Pause somente a etapa que precisa da identidade ou do consentimento da pessoa. Enquanto ela
conclui, finalize as verificações de instalação e prepare o rascunho original sem
inventar uma conta ou um workspace. Explique o que já está pronto e a única
ação necessária a seguir. Depois do login, consulte novamente o contexto autenticado e retome o
mesma tarefa. Não desative CAPTCHA, use APIs de cadastro de administrador, peça tokens,
ou afirme que a conta/conexão está pronta antes de concluir o fluxo real.

Se as ferramentas MCP exigirem recarregar o host, a CLI local também está disponível para este
assistente. Execute `npx -y sosoapi auth status` primeiro; use
`npx -y sosoapi auth login` somente quando o login for necessário. Nunca leia o
arquivo de credenciais nem imprima tokens. Se o login abrir o perfil errado do navegador, pare
esse login pendente antes de iniciar um novo `npx -y sosoapi auth login --no-open`.
A pessoa abre o novo link impresso no perfil desejado e confere a
identidade conectada antes de aprovar. Nunca use dois perfis simultaneamente no mesmo link.
Use `--help` primeiro para confirmar que esta flag de recuperação existe na CLI instalada;
se ausente, explique a limitação da versão em vez de inventar uma flag funcional.
A CLI pode consultar seus contratos incorporados:

```sh
npx -y sosoapi api contract --summary
npx -y sosoapi api contract --route /studio-api/scheduled-posts/
```

A sintaxe de requisição da CLI é `sosoapi api post </allowlisted-route> < request.json`.
Escreva o JSON com sua ferramenta de arquivos; não interpole conteúdo do usuário em comandos shell
comandos. Leia http_status e o corpo da resposta, não apenas a saída do processo
código. Um erro de API não é sucesso. Use somente rotas e schemas do
contrato incorporado; não invente nomes nem contorne uma capacidade ausente.

## 3. Conecte a própria conta social da pessoa

Resolva Organization e Workspace autenticados a partir do contexto do SosoAPI.
Nunca adivinhe identificadores nem substitua silenciosamente por outro workspace. Se
houver mais de uma marca adequada, pergunte qual a pessoa pretende usar.

Use uma conexão existente quando estiver íntegra. Caso contrário, execute
`npx -y sosoapi connect <platform>` (instagram, threads, facebook, youtube ou x)
ou dê à pessoa https://app.sosoapi.ai/connect. Eles concluem o consentimento do provedor
consentimento e revise a conta exata no navegador. Após o retorno,
consulte novamente as contas e capacidades de publicação. Um callback de conexão não é
prova de que publicar é permitido. Reutilize o rascunho original; não peça à
pessoa que copie um identificador interno ou recrie seu conteúdo.

## 4. Conclua a tarefa original de publicação

Use a solicitação existente da pessoa ou pergunte o que ela quer promover. Não
invente um post de teste. Mostre conta de destino exata, conteúdo, mídia e
data/horário locais antes do primeiro envio. Confirme o fuso quando estiver
desconhecido. Consulte as informações atuais de capacidades da conta; uma conta pessoal do Instagram ou a ausência de
as permissões do provedor podem exigir um tipo de conta compatível ou reconexão.

O X aceita apenas texto e links originais; mantenha media vazio. Mídia e respostas no X,
citações, reposts e publicação de threads não são compatíveis.

Para destinos compatíveis com mídia, registre-a antes de agendar: para arquivo local, use sosoapi_upload_asset
nas pastas permitidas; para URL externa, use sosoapi_import_asset_url
e consulte sosoapi_get_asset_import_status com include_asset=true até o
importação limitada esteja pronta. O asset.id pronto se torna media.asset_id e
asset.asset_url se torna media.url; não exige uma chamada get_asset separada.
Mantenha a mesma identidade de importação, respeite a orientação de repetição e pare em um estado terminal
falha. Uma requisição bem-sucedida não comprova que a decodificação/importação foi concluída.
Se o progresso parar, consulte sosoapi_job_status usando o job_id dessa importação antes de
aguardar novamente. Um job pendente já pode conter um erro de execução. Um serviço
erro de configuração exige atenção do operador, não outra importação, uma nova conta social
conexão ou permissão da pessoa. Informe o impedimento sem afirmar
a imagem está pronta.
Use o ID retornado do ativo registrado junto à URL canônica da mídia. Nunca
agende a URL externa original ou uma URL de prévia temporária como substituta.
Reutilize um ativo existente pronto somente após conferir seu workspace e identidade.

Use sosoapi_get_scheduled_post_eligibility quando uma prévia consultiva for útil;
é opcional e não substitui a validação canônica de criação/execução.
Use o Scheduled Post canônico
ferramentas. Um post corresponde a um destino. Reutilize a mesma idempotency_key nas repetições
da mesma requisição exata; um rascunho alterado é uma nova requisição. Após um timeout,
consulte o post existente antes de outra ação. Nunca reenvie cegamente uma
gravação incerta no provedor. Atualizações, cancelamento e repetição explícita usam a
versão atual e a elegibilidade da ação no servidor.

O resultado deve distinguir:

- Agendado: aceito para o horário informado; ainda não publicado.
- Em andamento ou em reconciliação: o resultado final não está confirmado; não reenvie.
- Publicado: um resultado terminal respaldado pelo provedor confirma o post exato;
  retorne o link no ar quando disponível.
- Falhou ou exige atenção: diga o que se sabe e a próxima ação permitida;
  reconecte somente a conta afetada quando a pessoa precisar conceder acesso novamente.

Para vários destinos, informe cada um separadamente. Não classifique toda a tarefa como
bem-sucedido quando apenas algumas plataformas tiveram sucesso. Para um agendamento futuro, retorne
os IDs dos posts e horários aceitos; não mantenha a conversa esperando até
o horário previsto nem crie um loop de consultas. Ao retornar, consulte os mesmos posts novamente.
A pessoa também pode consultar novamente o resultado exato em
https://app.sosoapi.ai/scheduled-posts/<post-id>, usando o ID real retornado
pelo SosoAPI. Essa página exige o próprio login autorizado da pessoa. Para um ambiente personalizado
ambiente, use a origem do app explicitamente configurada.
Não prometa reativar um assistente fechado nem enviar uma notificação de sucesso que
não foi configurado e verificado.

## Referências

- Início rápido para pessoas: https://app.sosoapi.ai/start
- Guia do produto: https://sosoapi.ai/pt-br/docs/quickstart
- Escopo compatível: Instagram, Threads, Páginas do Facebook, YouTube e conteúdo original no X
  texto/links. Formatos e permissões variam por conta; outras plataformas não são
  disponíveis só porque a pessoa os solicita.