Mensagem do LinkedIn
linkedin_messageEnvie uma mensagem direta do LinkedIn para um membro-alvo.
Quando usar
Envie uma mensagem direta para uma conexão existente do LinkedIn ou uma conversa conhecida.
linkedin:accesssalestouch:useRequisitos
Exemplo
Envie “Obrigado pela conexão, será um prazer trocar ideias.” para https://www.linkedin.com/in/example.
{
"linkedin_url": "https://www.linkedin.com/in/example",
"text": "Thanks for connecting, happy to compare notes.",
"queue": true
}{
"content": [
{
"type": "text",
"text": "{\n \"data\": { ... },\n \"meta\": null\n}"
}
],
"isError": false
}Resultado esperado: Um resultado de mensagem enviada ou colocada na fila com o identificador da ação.
Parâmetros
account_idstringID, nome de usuário, e-mail, identificador ou URL da conta da SalesTouch conectada.
identifierstringIdentificador, ID público, ID da conta ou URL do perfil do membro do LinkedIn.
queuebooleanDefina como true para colocar esta ação na fila quando não puder ser executada agora.
scheduled_forstringData e hora ISO 8601 futura com fuso horário. A ação nunca será executada antes desse horário e o enfileiramento é implícito.
textstringTexto da mensagem a enviar. Required unless attachments are provided.
attachmentsarrayAnexos 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_keystringChave estável da mensagem com anexos, com até 120 caracteres. A mesma chave e conteúdo nunca geram dois envios. Sem chave, mensagens idênticas são deduplicadas; altere-a intencionalmente apenas para um novo envio.
linkedin_conversation_idstringID opcional de uma conversa existente no LinkedIn. conversation_id é reservado para a sessão de análise MCP.
bypass_rate_limitbooleanSubstituir o comportamento da fila conforme as respostas. Mensagens para leads que já responderam ignoram por padrão os limites de envio em fila, a menos que queue ou scheduled_for esteja definido.
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_scopeReconecte o MCP e aprove a permissão solicitada do LinkedIn.
paid_plan_requiredSiga 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_requiredTente 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.
action_limit_queue_requiredRepita a chamada com queue definido como true.
message_requires_connectionO membro não é uma conexão de 1º grau e a conta não pode enviar InMail para ele. Chame retry_tool (linkedin_invite_then_message) com retry_with; não tente linkedin_message de novo.
inmail_credits_exhaustedA conta não tem mais créditos de InMail. Use linkedin_invite_then_message ou aguarde a recarga dos créditos.
message_too_longEncurte o texto e envie novamente.
recipient_unreachableO LinkedIn não entregará mensagens a este membro a partir desta conta. Não tente novamente.