SalesTouch Docs
Todas as ferramentas MCP
Grava no LinkedInLinkedIn

Convite do LinkedIn e depois mensagem

linkedin_invite_then_message

Envie um convite agora e, depois que o membro aceitar, envie automaticamente uma mensagem de acompanhamento.

Quando usar

Convide um membro agora e envie automaticamente um acompanhamento depois da aceitação.

Escopos necessários
linkedin:accesssalestouch:use
Execução
Chamada síncrona de ferramenta MCP

Requisitos

Forneça um membro-alvo: identifier, recipient, linkedin_url, profile_url ou handle.
Forneça o conteúdo do acompanhamento com follow_up_message, follow_up_text, message ou text.
O parâmetro opcional follow_up_attachments usa um attachment_id enviado de forma durável, content_base64 ou uma url HTTPS pública. Até 5 arquivos e 60 MB no total; content_base64 inline é limitado a 3 MB por requisição, então envie arquivos maiores por url ou attachment_id. HTML e caminhos locais não são aceitos. Os arquivos aguardam a aceitação por até 90 dias.
Defina retry_invitation somente depois que o usuário pedir explicitamente para substituir um fluxo de convite pendente existente.

Exemplo

Peça ao seu agente

Convide https://www.linkedin.com/in/example e, depois da aceitação, envie “Obrigado pela conexão.”

Argumentos da ferramenta
{
  "linkedin_url": "https://www.linkedin.com/in/example",
  "invite_message": "Would love to connect.",
  "follow_up_message": "Thanks for connecting."
}
Envelope da resposta MCP
{
  "content": [
    {
      "type": "text",
      "text": "{\n  \"data\": { ... },\n  \"meta\": null\n}"
    }
  ],
  "isError": false
}

Resultado esperado: Estado do convite e identificador persistente do acompanhamento.

Parâmetros

account_id
string

ID, nome de usuário, e-mail, identificador ou URL da conta da SalesTouch conectada.

identifierobrigatório
string

Identificador, ID público, ID da conta ou URL do perfil do membro do LinkedIn.

queue
boolean

Defina como true para colocar esta ação na fila quando não puder ser executada agora.

scheduled_for
string

Data e hora ISO 8601 futura com fuso horário. A ação nunca será executada antes desse horário e o enfileiramento é implícito.

invite_message
string

Nota de convite opcional.

follow_up_message
string

Mensagem a enviar quando o convite for aceito. Required unless follow_up_attachments are provided.

follow_up_attachments
array

Anexos nativos: até 5 arquivos e 60 MB no total. Use um attachment_id enviado, uma URL HTTPS pública ou bytes base64; o base64 inline é limitado a 3 MB por requisição, então envie arquivos maiores por url ou attachment_id. Caminhos locais e HTML não são aceitos. Envie os arquivos selecionados por /api/linkedin/attachments no aplicativo e informe seu attachment_id.

idempotency_key
string

Chave estável do acompanhamento com anexos. Acompanhamentos idênticos são deduplicados por padrão.

retry_invitation
boolean

Autorização explícita para outra tentativa após um envio confirmado. Nunca ignora resultados incertos nem o prazo de 3 semanas registrado; não percorre todos os convites.

Os aliases são exibidos separadamente porque os clientes MCP enviam um objeto JSON plano. Use apenas um alias de cada grupo obrigatório, não todos os aliases.

Erros comuns

insufficient_scope

Reconecte o MCP e aprove a permissão solicitada do LinkedIn.

paid_plan_required

Siga a action_url do erro: inicie o período de teste gratuito, escolha um plano se o teste ou a assinatura terminou, ou atualize a forma de pagamento após um pagamento recusado. details.reason indica o caso.

trial_payment_method_required

Tente novamente em um minuto se o checkout acabou de ser concluído; caso contrário, adicione uma forma de pagamento no faturamento da SalesTouch para ativar o período de teste e o acesso ao MCP do LinkedIn.

invitation_note_too_long

Mantenha a nota abaixo de 300 caracteres (200 em contas gratuitas) ou chame retry_tool com retry_with para enviá-la sem nota.

invitation_note_unavailable

A conta esgotou seus convites personalizados. Chame retry_tool com retry_with para enviar o convite sem nota.

invitation_limit_reached

A conta atingiu o limite semanal de convites do LinkedIn. Pare de convidar a partir dela por vários dias; coloque os convites na fila ou agende-os.

invitation_already_pending

Um convite já foi enviado. Verifique lead_status; não envie outro.

invitation_requires_email

Este membro só aceita convites de pessoas que conhecem seu e-mail. Entre em contato de outra forma.

Nesta página

Quando usarRequisitosExemploParâmetrosErros comunsFerramentas relacionadas