Guia de migração

Importe seu histórico de conversas

Está saindo de outra ferramenta de chat ou de helpdesk? Exporte seu histórico em CSV ou em qualquer outro arquivo, entregue ao seu assistente de IA e ele traz cada conversa para o Sonny pelo nosso servidor MCP. Funciona com qualquer ferramenta, porque a sua IA faz o mapeamento.

Nada é enviado

As conversas importadas são só histórico. O Sonny não envia e-mails nem mensagens aos seus clientes, não avisa sua equipe, não dispara webhooks, não executa respostas de IA nem regras da caixa de entrada e não envia pesquisas de satisfação por elas. Elas chegam fechadas e já lidas, então sua caixa de entrada continua tranquila.

Antes de começar

O Sonny conectado ao seu assistente de IA
Adicione o servidor MCP do Sonny ao Claude, ao Cursor ou a outro app de IA. O guia de MCP leva cerca de um minuto.
Uma exportação da sua ferramenta antiga
Uma exportação em CSV, JSON ou planilha com suas conversas e mensagens. Se sua ferramenta antiga guarda os arquivos como links, mantenha essas colunas: o Sonny consegue baixá-los.
Um canal para receber a importação
Os chats importados usam o site do canal e os e-mails importados usam o endereço de e-mail dele. Sua IA pode listar seus canais e perguntar qual usar.

Passo a passo

  1. 01

    Conecte o Sonny

    Conecte o servidor MCP do Sonny ao seu assistente de IA e entre no seu espaço de trabalho. Se você conectou antes de hoje, reconecte para que sua IA veja a nova ferramenta de importação.

  2. 02

    Entregue sua exportação

    Anexe o arquivo ou indique onde ele está para sua IA e diga em qual canal importar.

  3. 03

    Peça para importar

    Use o prompt abaixo como ponto de partida. Sua IA lê o arquivo, ajusta ao formato do Sonny e envia em lotes.

  4. 04

    Confira os resultados

    Sua IA relata o que foi importado e os problemas encontrados. Abra algumas conversas no Sonny para ver se estão certas e deixe que ela termine o resto.

Exemplo de prompt

Troque os nomes das colunas para os do seu arquivo.

prompt
Importe as conversas de export.csv para o meu canal "Support" do Sonny usando a ferramenta import_conversations.
Cada linha é uma mensagem. Agrupe as linhas por ticket_id, que é o externalId da conversa, e use message_id como externalId de cada mensagem.
Mensagens de clientes são incoming, respostas de agentes são outgoing e comentários privados são note.
Use created_at como sentAt (os horários estão em UTC) e attachment_url para attachments.
Importe 5 conversas primeiro para eu conferir no Sonny, depois importe o restante em lotes de 20 e me mostre os totais.

O que é importado

Conversas
Assunto, status, tags e responsável, como conversas de chat ou e-mail no seu canal.
Mensagens
Mensagens de clientes, respostas da equipe, notas internas e respostas do chatbot, cada uma com a data e a hora originais.
Contatos
Identificados pelo endereço de e-mail e criados quando são novos. Contatos que você já tem no Sonny nunca são alterados.
Anexos
Imagens, PDFs, documentos, planilhas e arquivos ZIP de até 25MB, a partir de um link público ou enviados como o próprio arquivo.

O formato de importação

Sua IA envia as conversas neste formato. Você não precisa escrevê-lo, mas ajuda saber para que serve cada campo.

json
{
  "sourceId": "source_shop",
  "conversations": [
    {
      "externalId": "crisp-8812",
      "subject": "Delivery question",
      "contact": {
        "email": "ada@example.com",
        "name": "Ada"
      },
      "tags": [
        "Shipping"
      ],
      "messages": [
        {
          "externalId": "1",
          "direction": "incoming",
          "body": "Has my order shipped?",
          "sentAt": "2025-03-14T09:30:00Z"
        },
        {
          "externalId": "2",
          "direction": "outgoing",
          "body": "Yes, it left this morning.",
          "sentAt": "2025-03-14T09:41:00Z",
          "author": {
            "name": "Sam",
            "email": "sam@yourcompany.com"
          }
        },
        {
          "externalId": "3",
          "direction": "incoming",
          "body": "",
          "sentAt": "2025-03-14T09:45:00Z",
          "attachments": [
            {
              "url": "https://files.example.com/receipt.pdf"
            }
          ]
        }
      ]
    }
  ]
}
externalId
O ID da conversa na sua ferramenta antiga. Obrigatório. Importar o mesmo ID de novo só adiciona o que é novo.
messages
As mensagens da conversa. Cada uma precisa de uma direção (incoming, outgoing ou note), um corpo e sentAt.
sentAt
Quando a mensagem foi enviada, em ISO 8601 com fuso horário, por exemplo 2025-03-14T09:30:00Z.
author
Quem escreveu. O e-mail de um colega vincula a resposta a ele no Sonny, e o tipo bot marca as respostas do chatbot.
contact
O endereço de e-mail e o nome do cliente.
status
open, pending ou closed. O padrão é closed.
channel
chat ou email. O padrão é chat quando o canal tem um site.
attachments
Arquivos, cada um como url https pública, ou como fileName, contentType e dataBase64.
tags
Nomes de tags. As tags novas são criadas para você.
assigneeEmail
O colega a quem atribuir a conversa.

Bom saber

  • Pode rodar de novo. Se uma importação parar no meio, rode-a outra vez. As mensagens que já chegaram são ignoradas e os anexos que falharam são tentados de novo.
  • Lotes. Cada chamada aceita até 50 conversas, 1.000 mensagens e 25 anexos. Sua IA divide as importações maiores para você.
  • Sem e-mail? A conversa é importada mesmo assim, só que sem contato. O nome do cliente continua nas mensagens dele.
  • Colegas. Uma resposta é vinculada a um colega quando o e-mail do autor corresponde a alguém do seu espaço de trabalho. Caso contrário, ela mantém o nome da sua ferramenta antiga.
  • Quem pode importar. Proprietários, administradores e agentes. As chaves de API precisam de acesso de escrita a conversas, mensagens e contatos, além de anexos para arquivos.

Para desenvolvedores

Não usa um assistente de IA? Envie o mesmo JSON para POST /api/v1/conversations/import com uma chave de API. A referência da API traz o esquema completo.

Documentos relacionados